Set-CMApplication
Set-CMApplication
Sets properties of an application in Configuration Manager.
Syntax
Parameter Set: SetById
Set-CMApplication -Id <String[]> [-AutoInstall <Boolean> ] [-Description <String> ] [-DistributionPointSetting <DistributionPointSettingType> {AutoDownload | DeltaCopy | NoDownload} ] [-DistributionPriority <DistributionPriorityType> {High | Low | Medium} ] [-Keyword <String> ] [-LinkText <String> ] [-LocalizedApplicationDescription <String> ] [-LocalizedApplicationName <String> ] [-Manufacturer <String> ] [-NewName <String> ] [-OptionalReference <String> ] [-Owner <String> ] [-ReleaseDate <DateTime> ] [-SendToProtectedDistributionPoint <Boolean> ] [-SoftwareVersion <String> ] [-SupportContact <String> ] [-UserCategories <String[]> ] [-UserDocumentation <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByName
Set-CMApplication -Name <String[]> [-AutoInstall <Boolean> ] [-Description <String> ] [-DistributionPointSetting <DistributionPointSettingType> {AutoDownload | DeltaCopy | NoDownload} ] [-DistributionPriority <DistributionPriorityType> {High | Low | Medium} ] [-Keyword <String> ] [-LinkText <String> ] [-LocalizedApplicationDescription <String> ] [-LocalizedApplicationName <String> ] [-Manufacturer <String> ] [-NewName <String> ] [-OptionalReference <String> ] [-Owner <String> ] [-ReleaseDate <DateTime> ] [-SendToProtectedDistributionPoint <Boolean> ] [-SoftwareVersion <String> ] [-SupportContact <String> ] [-UserCategories <String[]> ] [-UserDocumentation <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMApplication -InputObject <IResultObject> [-AutoInstall <Boolean> ] [-Description <String> ] [-DistributionPointSetting <DistributionPointSettingType> {AutoDownload | DeltaCopy | NoDownload} ] [-DistributionPriority <DistributionPriorityType> {High | Low | Medium} ] [-Keyword <String> ] [-LinkText <String> ] [-LocalizedApplicationDescription <String> ] [-LocalizedApplicationName <String> ] [-Manufacturer <String> ] [-NewName <String> ] [-OptionalReference <String> ] [-Owner <String> ] [-ReleaseDate <DateTime> ] [-SendToProtectedDistributionPoint <Boolean> ] [-SoftwareVersion <String> ] [-SupportContact <String> ] [-UserCategories <String[]> ] [-UserDocumentation <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetSecurityScopeById
Set-CMApplication -Id <String[]> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetSecurityScopeByName
Set-CMApplication -Name <String[]> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetSecurityScopeByValue
Set-CMApplication -InputObject <IResultObject> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMApplication cmdlet sets properties of an application.
Parameters
-AutoInstall<Boolean>
Specifies whether the task sequence action can install the application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Description<String>
Specifies a description for the application.
Aliases |
LocalizedDescription |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DistributionPointSetting<DistributionPointSettingType>
Specifies the pre-staged distribution point settings. The acceptable values for this parameter 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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DistributionPriority<DistributionPriorityType>
Specifies the order in which packages are sent to other sites. Packages with a high priority are sent before packages with a low or medium priority. Packages with equal priority are sent in the order they are created.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<String[]>
Specifies an array of application IDs.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies an application object. To obtain an application object, use the Get-CMApplication cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Keyword<String>
Specifies a key word for the application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LinkText<String>
Specifies a description that appears in the Application Catalog. The text accompanies the hyperlink to additional information or documentation about this application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LocalizedApplicationDescription<String>
Specifies the localized description string that appears in the client software center or catalog web site.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LocalizedApplicationName<String>
Specifies the localized name string that appears in the client software center or catalog web site.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Manufacturer<String>
Specifies a name of the manufacturer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies an array of names for the application.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-NewName<String>
Specifies a new name for the application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OptionalReference<String>
Specifies the optional reference information for this application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Owner<String>
Specifies one or more administrative users who are the owners of this application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ReleaseDate<DateTime>
Specifies a release date of the application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecurityScopeAction<SecurityScopeActionType>
Specifies a name of a security scope action.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecurityScopeName<String>
Specifies a name of a security scope.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SendToProtectedDistributionPoint<Boolean>
Specifies whether to copy this application to protected distribution points.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SoftwareVersion<String>
Specifies a software version for an application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SupportContact<String>
Specifies one or more administrative users who are support contacts for this application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UserCategories<String[]>
Specifies an array of categories for which software is a member. Use this parameter to identify a group, or category, of software, such as office productivity or graphics.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UserDocumentation<String>
Specifies a hyperlink to additional information for this application, in URI format.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Set an application
This example sets security scope action for an application.
PS C:\> Set-CMApplication -SecurityScopeAction AddMembership -SecurityScopeName "22" -Name "adw"