New-CMApplication

Creates an application.

Syntax

New-CMApplication
   [-Name] <String>
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-ReleaseDate <DateTime>]
   [-AutoInstall <Boolean>]
   [-Owner <String>]
   [-SupportContact <String>]
   [-LocalizedName <String>]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String>]
   [-PrivacyUrl <String>]
   [-IsFeatured <Boolean>]
   [-IconLocationFile <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-CMApplication cmdlet creates an application in Microsoft System Center Configuration Manager.

Examples

Example 1: Create an application

PS C:\> 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, see https://contoso.com/content" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "C:\Users\administrator\Desktop\icon.png" -DisplaySupersedenceInApplicationCatalog $True

This command creates an application named Application01.

Required Parameters

-Name

Specifies a name for the application.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AutoInstall

Indicates whether a task sequence action can install the application.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the application. The description appears in the Configuration Manager console.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisplaySupersedenceInApplicationCatalog

Indicates whether the application displays supersedence in the Application Catalog.

Type:Boolean
Aliases:DisplaySupersedencesInApplicationCatalog
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IconLocationFile

Specifies the location of the icon file. This is set to the single default language.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsFeatured

Indicates whether the application displays as a featured app and is highlighted in the company portal.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Keyword

Specifies a keyword for the application. Provide the keyword in the default language. To add multiple keywords, use CultureInfo.CurrentCulture.TextInfo.ListSeparator as the delimiter.

This keyword will help users of Software Center search for the application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LinkText

Specifies a description that appears in the Application Catalog with a hyperlink to additional information or documentation for the application. This is set to the single default language.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LocalizedDescription

Specifies a localized description string that appears in the client software center or catalog web site. This is set to the single default language.

Type:String
Aliases:LocalizedApplicationDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LocalizedName

Specifies a localized name string that appears in the client software center or catalog web site. This is set to the single default language.

Type:String
Aliases:LocalizedApplicationName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OptionalReference

Specifies optional reference information for the application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Owner

Specifies an owner for the application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrivacyUrl

Specifies a hyperlink, in URI format, to privacy information about the application. This is set to the single default language.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Publisher

Specifies the name of the software publisher.

Type:String
Aliases:Manufacturer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ReleaseDate

Specifies a release date for the application.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareVersion

Specifies a software version for the application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportContact

Specifies one or more administrative users who are support contacts for the application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDocumentation

Specifies a hyperlink, in URI format, to additional information about the application. This is set to the single default language.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False