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} ] [-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: 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> ] [-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 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. System Center 2012 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 Microsoft Application Virtualization 5 (.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 a Microsoft Application Virtualization 5 (.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. Acceptable values for this parameter 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

-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

-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 example 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 example 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

Get-CMDeploymentType

Remove-CMDeploymentType