Set-CMWindowsAppxDeploymentType
Sets a Windows app package deployment type.
Syntax
Set-CMWindowsAppxDeploymentType
[-ContentFallback <Boolean>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-TriggerVpn <Boolean>]
[-AddRequirement <Rule[]>]
-ApplicationName <String>
[-ContentLocation <String>]
-DeploymentTypeName <String>
[-NewName <String>]
[-PassThru]
[-RemoveLanguage <String[]>]
[-RemoveRequirement <Rule[]>]
[-AddLanguage <String[]>]
[-Comment <String>]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMWindowsAppxDeploymentType
[-ContentFallback <Boolean>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-TriggerVpn <Boolean>]
[-AddRequirement <Rule[]>]
-Application <IResultObject>
[-ContentLocation <String>]
-DeploymentTypeName <String>
[-NewName <String>]
[-PassThru]
[-RemoveLanguage <String[]>]
[-RemoveRequirement <Rule[]>]
[-AddLanguage <String[]>]
[-Comment <String>]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMWindowsAppxDeploymentType
[-ContentFallback <Boolean>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-TriggerVpn <Boolean>]
[-AddRequirement <Rule[]>]
-ApplicationId <Int32>
[-ContentLocation <String>]
-DeploymentTypeName <String>
[-NewName <String>]
[-PassThru]
[-RemoveLanguage <String[]>]
[-RemoveRequirement <Rule[]>]
[-AddLanguage <String[]>]
[-Comment <String>]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMWindowsAppxDeploymentType
[-ContentFallback <Boolean>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-TriggerVpn <Boolean>]
[-AddRequirement <Rule[]>]
[-ContentLocation <String>]
-InputObject <IResultObject>
[-NewName <String>]
[-PassThru]
[-RemoveLanguage <String[]>]
[-RemoveRequirement <Rule[]>]
[-AddLanguage <String[]>]
[-Comment <String>]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
The Set-CMWindowsAppxDeploymentType cmdlet changes the settings for a Windows app package deployment type.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Examples
Example 1: Modify an app package deployment type
PS XYZ:\> Set-CMWindowsAppxdeploymentType -ApplicationName "Application1" -DeploymentTypeName "DTS" -NewName "DTS_New" -AddLanguage "en-US","zh-CN" -Comment "Deployment Type updated"This command changes the name of the Windows app package deployment type named DTS for the application named Application1 to DTS_New, adds English and Chinese as supported languages, and adds a description.
Example 2: Modify an app package deployment type by using the pipeline
PS XYZ:\> Get-CMDeploymentType -ApplicationName "Application1" -DeploymentTypeName "DTS" | Set-CMWindowsAppxDeploymentType -NewName "DTS_New" -AddLanguage "en-US","zh-CN" -Comment "Deployment Type updated"This command gets the Windows app package deployment type object named DTS for the application named Application1 and uses the pipeline operator to pass the object to Set-CMWindowsAppxDeploymentType. Set-CMWindowsAppxDeploymentType changes the name of the deployment type to DTS_New, adds English and Chinese as supported languages, and adds a description.
Parameters
-AddLanguage
Adds an array of languages that this deployment type supports. Provide the languages in the "languagecode2-country" or "languagecode2" format, for example: en, en-US, ja-JP, zh-CN.
For more information, see CultureInfo.Name.
| Type: | String[] |
| Aliases: | AddLanguages, Languages, Language |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddRequirement
Adds an array of requirements for this deployment type.
| Type: | Rule[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Application
Specifies an application object that is associated with this deployment type. To obtain an application object, use the Get-CMApplication cmdlet.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationId
Specifies the ID of the application that is associated with this deployment type.
| Type: | Int32 |
| Aliases: | CI_ID, CIId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Specifies the name of the application that is associated with this deployment type.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Comment
Specifies a description for this deployment type.
| Type: | String |
| Aliases: | AdministratorComment |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentFallback
Indicates that a client can use a fallback location provided by a management point. A fallback location point provides an alternate location for source content when the content for the deployment type is not available on any of the preferred distribution points.
| Type: | Boolean |
| Aliases: | EnableContentLocationFallback, AllowClientsToUseFallbackSourceLocationForContent |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentLocation
Specifies the path of the content. The site system server requires permissions to read the content files.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentTypeName
Specifies a display name for this deployment type.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
| Type: | SwitchParameter |
| Aliases: | ForceForUnknownPublisher |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specifies a deployment type object. To obtain a deployment type object, use the Get-CMDeploymentType cmdlet.
| Type: | IResultObject |
| Aliases: | DeploymentType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NewName
Specifies a new name for this deployment type.
| Type: | String |
| Aliases: | NewDeploymentTypeName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveLanguage
Removes an array of existing languages from this deployment type. Provide the languages in the "languagecode2-country" or "languagecode2" format, for example: en, en-US, ja-JP, zh-CN.
| Type: | String[] |
| Aliases: | RemoveLanguages |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveRequirement
Removes the existing installation requirements from this deployment type.
| Type: | Rule[] |
| Aliases: | RemoveRequirements |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlowNetworkDeploymentMode
Specifies the installation behavior of the deployment type on a slow network. Valid values are:
- DoNothing
- Download
- DownloadContentForStreaming
| Type: | ContentHandlingMode |
| Accepted values: | DoNothing, Download |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TriggerVpn
Indicates that a virtual private network (VPN) connection is used automatically.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Outputs
System.Object
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for