Set-​CM​Client​Push​Installation

Changes settings of a client push installation.

Syntax

Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-InstallClientToDomainController <Boolean>]
   [-InstallationProperty <String>]
   [-RemoveAccount <String[]>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-InstallClientToDomainController <Boolean>]
   [-InstallationProperty <String>]
   [-RemoveAccount <String[]>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-ForceWildcardHandling]
   [-InstallClientToDomainController <Boolean>]
   [-InstallationProperty <String>]
   -Name <String>
   [-RemoveAccount <String[]>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-ForceWildcardHandling]
   [-InstallClientToDomainController <Boolean>]
   [-InstallationProperty <String>]
   [-RemoveAccount <String[]>]
   [-SiteCode <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMClientPushInstallation cmdlet changes the settings of an object that installs a Microsoft System Center Configuration Manager client by using client push. A client push installation installs client software on computers that System Center Configuration Manager discovered. When you configure client push installation for a site, the client installation automatically runs on the computers that System Center Configuration Manager discovered within the site's configured boundaries when those boundaries are part of a boundary group. You can also start a client push installation by running the Client Push Installation Wizard for a specific collection or resource within a collection.

For more information about how to install clients, see How to Install Clients on Windows-Based Computers in Configuration Manager on TechNet.

Examples

Example 1: Change the settings of a client push installation

PS C:\> Set-CMClientPushInstallation -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "CENTRAL\00ID$" -InstallationProperty "SMSSITECODE=CM1"

This command specifies that Configuration Manager automatically uses client push for discovered computers. The command specifies that Configuration Manager pushes the client software to site system servers and uses the account named CENTRAL\00ID$ to connect to the computer to install the client software. The InstallationProperty parameter sets the value of the SMSSITECODE property for the Windows Installer package to CM1. This setting assigns the client to the site that has the site code CM1.

Required Parameters

-InputObject

Specifies a client push installation object. To obtain a client push installation object, use the Get-CMClientPushInstallation cmdlet.

Type:IResultObject
Aliases:ClientPushComponent
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name for the client push installation.

Type:String
Aliases:SiteName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AddAccount

{{Fill AddAccount Description}}

Type:String[]
Aliases:AddAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ChosenAccount

Specifies an array of accounts for Configuration Manager to use when it connects to the computer to install the client software.

Type:String[]
Aliases:ChosenAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClearAccount

{{Fill ClearAccount Description}}

Type:SwitchParameter
Aliases:ClearAccounts
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableAutomaticClientPushInstallation

Indicates whether Configuration Manager automatically uses client push for discovered computers.

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

Indicates whether Configuration Manager pushes the client software to Configuration Manager site system servers.

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

Indicates whether Configuration Manager pushes the client software to servers.

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

Indicates whether Configuration Manager pushes the client software to workstations.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InstallClientToDomainController

Indicates whether to use automatic site-wide client push installation to install the Configuration Manager client software on domain controllers.

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

Specifies any installation properties to use when installing the Configuration Manager client.For System Center Configuration Manager with no service pack installed: You can specify only installation properties for the Windows Installer package (Client.msi); you cannot specify properties for CCMSetup.exe.

For System Center Configuration Manager SP1: You can specify installation properties for the Windows Installer package (Client.msi) and the following CCMSetup.exe properties: - forcereboot

  • skipprereq
  • logon
  • BITSPriority
  • downloadtimeout
  • forceinstall
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveAccount

{{Fill RemoveAccount Description}}

Type:String[]
Aliases:RemoveAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the site code of the Configuration Manager site that hosts the site system role.

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