description | external help file | Module Name | ms.date | schema | title |
---|---|---|---|---|---|
Create an application. |
AdminUI.PS.dll-Help.xml |
ConfigurationManager |
03/29/2021 |
2.0.0 |
New-CMApplication |
Create an application.
New-CMApplication [-AddOwner <String[]>] [-AddSupportContact <String[]>] [-AppCatalog <AppDisplayInfo[]>]
[-AutoInstall <Boolean>] [-DefaultLanguageId <Int32>] [-Description <String>]
[-DisplaySupersedenceInApplicationCatalog <Boolean>] [-IconLocationFile <String>] [-IsFeatured <Boolean>]
[-Keyword <String[]>] [-LinkText <String>] [-LocalizedDescription <String>] [-LocalizedName <String>]
[-Name] <String> [-OptionalReference <String>] [-Owner <String>] [-PrivacyUrl <String>] [-Publisher <String>]
[-ReleaseDate <DateTime>] [-SoftwareVersion <String>] [-SupportContact <String>] [-UserDocumentation <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
Use this cmdlet to create an application. A Configuration Manager application defines the metadata about application. For more information, see Create applications in Configuration Manager.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
This command creates an application named Application01.
New-CMApplication -Name "Application01" -Description "New Application" -Publisher "Contoso" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator" -SupportContact "Administrator" -LocalizedName "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more information" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "\\central\icons\icon.png"
Specify one or more administrative users who are responsible for this app.
Type: String[]
Parameter Sets: (All)
Aliases: AddOwners
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify one or more administrative users that end users can contact for help with this application.
Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Use this parameter to specify a Software Center entry for a specific language. This entry can include all of the localized information about the app:
- Description
- IconLocationFile
- Keyword
- LinkText
- PrivacyUrl
- Title
- UserDocumentation
To get this object, use the New-CMApplicationDisplayInfo cmdlet.
Type: AppDisplayInfo[]
Parameter Sets: (All)
Aliases: AppCatalogs
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Set this parameter to $true to allow the app to be installed from the Install Application task sequence step without being deployed.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify the language ID for the default Software Center language.
This ID is the decimal equivalent of the Windows language ID. For example, 1033
is 0x0409
for English (United States), and 2108
is 0x083C
for Irish (Ireland). For more information, see [MS-LCID]: Windows Language Code Identifier (LCID) Reference.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify an optional administrator comment for the app. The maximum length is 2048 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Don't use this parameter. The application catalog is no longer supported.
Type: Boolean
Parameter Sets: (All)
Aliases: DisplaySupersedencesInApplicationCatalog
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify the path to the file that contains the icon for this app. Icons can have pixel dimensions of up to 512x512. The file can be of the following image and icon file types:
- DLL
- EXE
- JPG
- ICO
- PNG
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Set this parameter to $true to display this application as a featured app and highlight it in the Company Portal.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify a list of keywords in the selected language. These keywords help Software Center users search for the app.
Tip
To add multiple keywords, use CultureInfo.CurrentCulture.TextInfo.ListSeparator as the delimiter.
Type: String[]
Parameter Sets: (All)
Aliases: Keywords
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
When you use the UserDocumentation parameter, use this parameter to show a string in place of "Additional information" in Software Center. The maximum length is 128 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify a description for this app in the selected language. The maximum length is 2048 characters.
Type: String
Parameter Sets: (All)
Aliases: LocalizedApplicationDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify the app name in the selected language. This name appears in Software Center.
A name is required for each language that you add.
The maximum length is 256 characters.
Type: String
Parameter Sets: (All)
Aliases: LocalizedApplicationName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify a name for the app. The maximum length is 256 characters.
Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify an optional string to help you find the app in the console. The maximum length is 256 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify an administrative user who's responsible for this app.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify a website address to the privacy statement for the app. The format needs to be a valid URL, for example https://contoso.com/privacy
. The maximum length of the entire string is 128 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify optional vendor information for this app. The maximum length is 256 characters.
Type: String
Parameter Sets: (All)
Aliases: Manufacturer
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify a date object for when this app was released. To get this object, use the Get-Date built-in cmdlet.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify an optional version string for the app. The maximum length is 64 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify an administrative user that end users can contact for help with this application.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specify the location of a file from which Software Center users can get more information about this app. This location is a website address, or a network path and file name. Make sure that users have access to this location.
The maximum length of the entire string is 256 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
For more information on this return object and its properties, see SMS_Application server WMI class.