Set-CMDeploymentType
Set-CMDeploymentType
Changes a deployment type.
Syntax
Parameter Set: SetByIdPriority
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeId <String> [-Priority <PriorityChangeType> {Decrease | Increase} ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePriority
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> [-Priority <PriorityChangeType> {Decrease | Increase} ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyAppV5xInstaller
Set-CMDeploymentType -ApplicationName <String> -AppV5xInstaller -DeploymentTypeName <String> [-AdministratorComment <String> ] [-AllowClientsToUseFallbackSourceLocationForContent <Boolean> ] [-ContentLocation <String> ] [-EnablePeertoPeerContentDistribution <Boolean> ] [-Language <String[]> ] [-NewDeploymentTypeName <String> ] [-OnFastNetworkMode <OnFastNetworkMode> {RunFromNetwork | RunLocal} ] [-OnSlowNetworkMode <ContentHandlingMode> {DoNothing | Download | DownloadContentForStreaming} ] [-PersistContentInClientCache <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyAppVInstaller
Set-CMDeploymentType -ApplicationName <String> -AppVInstaller -DeploymentTypeName <String> [-AdministratorComment <String> ] [-AllowClientsToUseFallbackSourceLocationForContent <Boolean> ] [-ContentLocation <String> ] [-EnablePeertoPeerContentDistribution <Boolean> ] [-Language <String[]> ] [-LoadContentIntoAppVcacheBeforelaunch <Boolean> ] [-NewDeploymentTypeName <String> ] [-OnFastNetworkMode <OnFastNetworkMode> {RunFromNetwork | RunLocal} ] [-OnSlowNetworkMode <ContentHandlingMode> {DoNothing | Download | DownloadContentForStreaming} ] [-PersistContentInClientCache <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyDeepLinkInstaller
Set-CMDeploymentType -ApplicationName <String> -DeepLinkInstaller -DeploymentTypeName <String> [-AdministratorComment <String> ] [-ApplicationNameInWindowsStore <String> ] [-Language <String[]> ] [-NewDeploymentTypeName <String> ] [-RemoteComputerName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyMacInstaller
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> -MacInstaller [-AdministratorComment <String> ] [-ContentLocation <String> ] [-InstallationProgram <String> ] [-Language <String[]> ] [-MacRebootBehavior <MacRebootBehavior> {ForceReboot | NoAction} ] [-NewDeploymentTypeName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyMsiConfigureRule
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> -MsiOrScriptInstaller [-AdministratorComment <String> ] [-AllowClientsToShareContentOnSameSubnet <Boolean> ] [-AllowClientsToUseFallbackSourceLocationForContent <Boolean> ] [-ContentLocation <String> ] [-DetectDeploymentTypeByCustomScript] [-EstimatedInstallationTimeMinutes <Int32> ] [-InstallationBehaviorType <InstallationBehaviorType> {InstallForSystem | InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser | InstallForUser} ] [-InstallationProgram <String> ] [-InstallationProgramVisibility <UserInteractionMode> {Normal | Minimized | Maximized | Hidden} ] [-InstallationStartIn <String> ] [-Language <String[]> ] [-LogonRequirementType <LogonRequirementType> {OnlyWhenNoUserLoggedOn | OnlyWhenUserLoggedOn | WhereOrNotUserLoggedOn | WhetherOrNotUserLoggedOn} ] [-MaximumAllowedRunTimeMinutes <Int32> ] [-NewDeploymentTypeName <String> ] [-OnSlowNetworkMode <ContentHandlingMode> {DoNothing | Download | DownloadContentForStreaming} ] [-PersistContentInClientCache <Boolean> ] [-ProductCode <String> ] [-RebootBehavior <RebootBehavior> {BasedOnExitCode | ForceReboot | NoAction | ProgramReboot} ] [-RequiresUserInteraction <Boolean> ] [-RunInstallationAndUninstallProgramAs32bitProcessOn64bitClient <Boolean> ] [-RunScriptAs32bitProcessOn64bitClient <Boolean> ] [-ScriptContent <String> ] [-ScriptType <ScriptLanguage> ] [-UninstallProgram <String> ] [-UninstallStartIn <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyOtherInstaller
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> [-AdministratorComment <String> ] [-ContentLocation <String> ] [-Language <String[]> ] [-NewDeploymentTypeName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyWebAppInstaller
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> -WebAppInstaller [-AdministratorComment <String> ] [-Language <String[]> ] [-NewDeploymentTypeName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyWindows8Installer
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> -Windows8AppInstaller [-AdministratorComment <String> ] [-AllowClientsToShareContentOnSameSubnet <Boolean> ] [-AllowClientsToUseFallbackSourceLocationForContent <Boolean> ] [-ContentLocation <String> ] [-Language <String[]> ] [-MaximumAllowedRunTimeMinutes <Int32> ] [-NewDeploymentTypeName <String> ] [-OnSlowNetworkMode <ContentHandlingMode> {DoNothing | Download | DownloadContentForStreaming} ] [-PersistContentInClientCache <Boolean> ] [-TriggerVPN <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByNamePropertyWmInstaller
Set-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> -WMInstaller [-AdministratorComment <String> ] [-AllowUserToUninstall <Boolean> ] [-ContentLocation <String> ] [-Language <String[]> ] [-NewDeploymentTypeName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValuePriority
Set-CMDeploymentType -ApplicationName <String> -InputObject <IResultObject> [-Priority <PriorityChangeType> {Decrease | Increase} ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMDeploymentType cmdlet changes a deployment type for a deployment application in Microsoft System Center 2012 SP1 Configuration Manager. A deployment type is a part of the application that defines how that application deploys other applications to devices. You can also use this cmdlet to change the priority for dependencies of the deployment type. Configuration Manager evaluates and installs dependencies of a deployment type in order of priorities before it installs the deployment type.
Parameters
-AdministratorComment<String>
Specifies a description for the deployment type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AllowClientsToShareContentOnSameSubnet<Boolean>
Indicates whether clients can share content with other clients on the same subnet.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AllowClientsToUseFallbackSourceLocationForContent<Boolean>
Indicates whether clients 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 preferred distribution points.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AllowUserToUninstall<Boolean>
Indicates whether a user can uninstall an application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ApplicationName<String>
Specifies the name of the deployment application that contains the deployment type.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ApplicationNameInWindowsStore<String>
Specifies the name of the application in the Windows Store.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AppV5xInstaller
Indicates that the deployment type detects application information and deployment types from a Application Virtualization (App-V) 5.0 .appv package file.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AppVInstaller
Indicates that the deployment type detects application information and deployment types from an App-V .appv package file.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ContentLocation<String>
Specifies the path of the content. The site system server requires permission to read the content files.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeepLinkInstaller
Indicates that the deployment type detects application information and deployment types by providing a link to the application (in the Windows Store) on a computer where the application is already installed.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeploymentTypeId<String>
Specifies the type ID for a deployment type.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeploymentTypeName<String>
Specifies the name of a deployment type.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DetectDeploymentTypeByCustomScript
Indicates that the deployment type uses a custom script to detect the presence of this deployment type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnablePeertoPeerContentDistribution<Boolean>
Indicates whether clients can distribute content to other clients.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EstimatedInstallationTimeMinutes<Int32>
Specifies, in minutes, the estimated installation time.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies a deployment type object for Configuration Manager. To obtain a deployment type object, use the Get-CMDeploymentType cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InstallationBehaviorType<InstallationBehaviorType>
Specifies the installation behavior of the deployment type. Valid values are:
-- InstallForSystem
-- InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
-- InstallForUser
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InstallationProgram<String>
Specifies the command line for the Windows Installer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InstallationProgramVisibility<UserInteractionMode>
Specifies the mode in which the deployment type runs on client devices. Valid values are:
-- Normal
-- Minimized
-- Maximized
-- Hidden
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InstallationStartIn<String>
Specifies the folder that contains the installation program for the deployment type. This folder can be an absolute path on the client, or a path to the distribution point folder that contains the installation files.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Language<String[]>
Specifies an array of languages that the deployment type supports.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LoadContentIntoAppVcacheBeforelaunch<Boolean>
Indicates whether to load the content into the AppV cache when you deploy the application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LogonRequirementType<LogonRequirementType>
Specifies the logon requirement for the deployment type. Valid values are:
-- OnlyWhenNoUserLoggedOn
-- OnlyWhenUserLoggedOn
-- WhereOrNotUserLoggedOn
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MacInstaller
Indicates that the deployment type detects application information and deployment types from a Mac OS X Installer (.cmmac) file that was created by using the CMAppUtil tool.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MacRebootBehavior<MacRebootBehavior>
Specifies the reboot behavior for computers running Mac OS X software.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MaximumAllowedRunTimeMinutes<Int32>
Specifies, in minutes, the maximum time that the program is expected to run on the client computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MsiOrScriptInstaller
Indicates that the deployment uses a script installer program.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-NewDeploymentTypeName<String>
Specifies the name of a new deployment type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OnFastNetworkMode<OnFastNetworkMode>
Specifies the installation behavior of the deployment type on a fast network. Valid values are:
-- RunFromNetwork
-- RunLocal
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OnSlowNetworkMode<ContentHandlingMode>
Specifies the installation behavior of the deployment type on a slow network. Valid values are:
-- DoNothing
-- Download
-- DownloadContentForStreaming
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-PersistContentInClientCache<Boolean>
Indicates whether the deployment type saves content in cache indefinitely on the client computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Priority<PriorityChangeType>
Specifies a change for the priority of the deployment type. Valid values are: Increase and Decrease.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ProductCode<String>
Specifies a product code.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RebootBehavior<RebootBehavior>
Specifies the reboot behavior of the client computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RemoteComputerName<String>
Specifies a remote computer name.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RequiresUserInteraction<Boolean>
Indicates whether a user can interact with the deployment type installation to configure the installation options.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RunInstallationAndUninstallProgramAs32bitProcessOn64bitClient<Boolean>
Indicates whether to run the install and uninstall programs as 32-bit processes on a 64-bit client computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RunScriptAs32bitProcessOn64bitClient<Boolean>
Indicates whether the deployment type uses Microsoft Windows-32-on-Windows-64 (WOW64) subsystem to run a script on a 64-bit client computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ScriptContent<String>
Specifies the script language that you want to use to detect the deployment type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ScriptType<ScriptLanguage>
Specifies the script language that you want to use to detect the deployment type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TriggerVPN<Boolean>
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UninstallProgram<String>
Specifies the name of the uninstall program and any parameters it requires.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UninstallStartIn<String>
Specifies the folder that contains the uninstall program for the deployment type. This folder can be an absolute path on the client, or a path that is relative to the distribution point folder that contains the package.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-WebAppInstaller
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Windows8AppInstaller
Indicates that the deployment type detects application information and deployment types from a Windows app package (.appx) file.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-WMInstaller
Indicates that the deployment type detects application information and deployment types from a Windows Mobile cabinet (.cab) file.
Aliases |
none |
Required? |
true |
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: Increase the priority of a deployment application
This command sets a deployment type named Configuration Manager Console - Windows Installer (Native) for a deployment application named 2 - Child and increases the priority of that application.
PS C:\> Set-CMDeploymentType -ApplicationName "2 - Child" -DeploymentTypeName "Configuration Manager Console - Windows Installer (Native)" -Priority Increase
Example 2: Decrease the priority of a deployment application
This command sets a deployment type named Configuration Manager Console - Windows Installer (Native) for a deployment application named 2 - Child and decreases the priority of that application.
PS C:\> Set-CMDeploymentType -ApplicationName "2 - Child" -DeploymentTypeName "Configuration Manager Console - Windows Installer (Native)" -Priority Decrease