Set-CMClientPushInstallation

Set-CMClientPushInstallation

Changes settings of a client push installation.

Syntax

Parameter Set: SearchByNameMandatory
Set-CMClientPushInstallation -Name <String> [-ChosenAccount <String[]> ] [-EnableAutomaticClientPushInstallation <Boolean> ] [-EnableSystemTypeConfigurationManager <Boolean> ] [-EnableSystemTypeServer <Boolean> ] [-EnableSystemTypeWorkstation <Boolean> ] [-InstallationProperty <String> ] [-InstallClientToDomainController <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchBySiteCodeMandatory
Set-CMClientPushInstallation -SiteCode <String> [-ChosenAccount <String[]> ] [-EnableAutomaticClientPushInstallation <Boolean> ] [-EnableSystemTypeConfigurationManager <Boolean> ] [-EnableSystemTypeServer <Boolean> ] [-EnableSystemTypeWorkstation <Boolean> ] [-InstallationProperty <String> ] [-InstallClientToDomainController <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Set-CMClientPushInstallation -InputObject <IResultObject> [-ChosenAccount <String[]> ] [-EnableAutomaticClientPushInstallation <Boolean> ] [-EnableSystemTypeConfigurationManager <Boolean> ] [-EnableSystemTypeServer <Boolean> ] [-EnableSystemTypeWorkstation <Boolean> ] [-InstallationProperty <String> ] [-InstallClientToDomainController <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMClientPushInstallation cmdlet changes the settings of an object that installs a Microsoft System Center 2012 SP1 Configuration Manager client by using client push. A client push installation installs client software on computers that System Center 2012 Configuration Manager discovered. When you configure client push installation for a site, the client installation automatically runs on the computers that System Center 2012 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 (https://go.microsoft.com/fwlink/?LinkId=247203) on TechNet.

Parameters

-ChosenAccount<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableAutomaticClientPushInstallation<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableSystemTypeConfigurationManager<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableSystemTypeServer<Boolean>

Indicates whether Configuration Manager pushes the client software to servers.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableSystemTypeWorkstation<Boolean>

Indicates whether Configuration Manager pushes the client software to workstations.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InstallationProperty<String>

Specifies any installation properties to use when installing the Configuration Manager client.

For System Center 2012 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 2012 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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InstallClientToDomainController<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies a name for the client push installation.

Aliases

SiteName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

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

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: Change the settings of a client push installation

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.

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

Get-CMClientPushInstallation

How to Install Clients on Windows-Based Computers in Configuration Manager