Set-CMClientPushInstallation
Changes settings of a client push installation.
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>]
The Set-CMClientPushInstallation cmdlet changes the settings of an object that installs a Microsoft System Center 2012 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 in the TechNet Library at https://go.microsoft.com/fwlink/?LinkId=247203.
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 |
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 |
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 |
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 |
Indicates whether Configuration Manager pushes the client software to worksatations.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
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 |
Specifies any installation properties to use when installing the Configuration Manager client.
For System Center 2012 Configuration Manager with no service pack: 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 |
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 |
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 |
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 |
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
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 |
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).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
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"