Set-CMApplication

Sets the properties of an application.

Syntax

Set-CMApplication
   [-Id] <Int32>
   [-AppCategory <String[]>]
   [-AutoInstall <Boolean>]
   [-Confirm]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-ForceWildcardHandling]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMApplication [-InputObject]  [-AppCategory ] [-AutoInstall ] [-Confirm]
 [-Description ] [-DisableWildcardHandling] [-DisplaySupersedenceInApplicationCatalog ]
 [-DistributionPointSetting ] [-DistributionPriority ]
 [-ForceWildcardHandling] [-IconLocationFile ] [-IsFeatured ] [-Keyword ]
 [-LinkText ] [-LocalizedApplicationName ] [-LocalizedDescription ] [-NewName ]
 [-OptionalReference ] [-Owner ] [-PassThru] [-PrivacyUrl ] [-Publisher ]
 [-ReleaseDate ] [-SendToProtectedDistributionPoint ] [-SoftwareVersion ]
 [-SupportContact ] [-UserCategory ] [-UserDocumentation ] [-WhatIf]
 []
Set-CMApplication [-AppCategory ] [-AutoInstall ] [-Confirm] [-Description ]
 [-DisableWildcardHandling] [-DisplaySupersedenceInApplicationCatalog ]
 [-DistributionPointSetting ] [-DistributionPriority ]
 [-ForceWildcardHandling] [-IconLocationFile ] [-IsFeatured ] [-Keyword ]
 [-LinkText ] [-LocalizedApplicationName ] [-LocalizedDescription ] -ModelName 
 [-NewName ] [-OptionalReference ] [-Owner ] [-PassThru] [-PrivacyUrl ]
 [-Publisher ] [-ReleaseDate ] [-SendToProtectedDistributionPoint ]
 [-SoftwareVersion ] [-SupportContact ] [-UserCategory ]
 [-UserDocumentation ] [-WhatIf] []
Set-CMApplication [-Name]  [-AppCategory ] [-AutoInstall ] [-Confirm]
 [-Description ] [-DisableWildcardHandling] [-DisplaySupersedenceInApplicationCatalog ]
 [-DistributionPointSetting ] [-DistributionPriority ]
 [-ForceWildcardHandling] [-IconLocationFile ] [-IsFeatured ] [-Keyword ]
 [-LinkText ] [-LocalizedApplicationName ] [-LocalizedDescription ] [-NewName ]
 [-OptionalReference ] [-Owner ] [-PassThru] [-PrivacyUrl ] [-Publisher ]
 [-ReleaseDate ] [-SendToProtectedDistributionPoint ] [-SoftwareVersion ]
 [-SupportContact ] [-UserCategory ] [-UserDocumentation ] [-WhatIf]
 []

Description

The Set-CMApplication cmdlet changes the settings of an application.

Examples

Example 1: Set the properties of an application by using the pipeline

PS C:\> Get-CMApplication -Name "Application01" | Set-CMApplication -NewName "Application01_New" -Description "Application updated" -Publisher "Test group" -SoftwareVersion 1.0.0.1 -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator1" -SupportContact "Administrator" -LocalizedApplicationName "Localized Application01" -UserDocumentation "https://contoso.com/content" -LinkText "Linktext" -LocalizedDescription "Localized Application New" -Keyword "Application" -PrivacyUrl "https://contoso.com/privacy" -IsFeatured $True -IconLocationFile "C:\Users\art\icon.png" -DisplaySupersedenceInApplicationCatalog $True -DistributionPriority Medium -SendToProtectedDistributionPoint $True -DistributionPointSetting NoDownload -UserCategory "userCategory1","userCategory2" -AppCategory "adminCategory1","adminCategory2"

The first command gets the application object named Application01 and uses the pipeline operator to pass the object to Set-CMApplication. Set-CMApplication sets the specified properties on Applicaton01.

Example 2: Get an application, rename it, and update its settings

PS C:\> Set-CMApplication -Name "Application01" -NewName "Application01_New" -Description "Application updated" -Publisher "Test group" -SoftwareVersion 1.0.0.1 -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator1" -SupportContact "Administrator" -LocalizedApplicationName Localized "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "LinkText" -LocalizedDescription "Localized Application New" -Keyword "Application" -PrivacyUrl "https://contoso.com/privacy" -IsFeatured $True -IconLocationFile "C:\Users\art\icon.png" -DisplaySupersedenceInApplicationCatalog $True -DistributionPriority Medium -SendToProtectedDistributionPoint $True -DistributionPointSetting NoDownload -UserCategory "userCategory1","userCategory2" -AppCategory "adminCategory1","adminCategory2"

This command gets the application named Application01, renames it to Application01_New, and sets the specified properties on the application.

Required Parameters

-Id

Specifies the CI_ID and ModelID properties (the same value) of an application.

Type:Int32
Aliases:CIId, CI_ID
Required:True
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies an application object. To obtain an application object, use the Get-CMApplication cmdlet.

Type:IResultObject
Aliases:Application
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ModelName

Specifies the model name of the application.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of the application.

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

Optional Parameters

-AppCategory

Specifies an array of administrative categories assigned to the application. Provide the categories by their name. Only categories of the type AppCategories are supported.

Type:String[]
Aliases:AppCategories
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AutoInstall

Indicates whether a task sequence action can install the application.

Type:Boolean
Required:False
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
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointSetting

Specifies the prestaged distribution point settings. Valid values are: - AutoDownload. Automatically download content when packages are assigned to distribution points.

  • DeltaCopy. Download only content changes to distribution points.

  • NoDownload. Manually copy the content in this package to distribution points.

Type:DistributionPointSettingType
Parameter Sets:AutoDownload, DeltaCopy, NoDownload
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPriority

Specifies the order in which packages are sent to other sites. Valid values are:- High

  • Medium
  • LowHigh priority packages are sent before packages with medium or low priority. Packages with equal priority are sent in the order in which they are created.
Type:DistributionPriorityType
Parameter Sets:High, Medium, Low
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
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
Required:False
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
Required:False
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
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LocalizedApplicationName

Specifies a localized name string that appears in the client software center or catalog web site.

Type:String
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies a new name for the application.

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

Specifies optional reference information for this application.

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

Specifies an owner for the application.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Publisher

Specifies the name of a software publisher.

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

Specifies a release date for the application.

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

Indicates whether to copy this application to protected distribution points.

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

Specifies a software version for an application.

Type:String
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserCategory

Specifies an array of user categories assigned to the application. You can use this parameter to identify a group or category of software, such as "office productivity" or "graphics."

Type:String[]
Aliases:UserCategories
Required:False
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
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False