Set-CMClientPushInstallation
配置客户端请求安装设置。
语法
Set-CMClientPushInstallation
[-AddAccount <String[]>]
[-AllownNTLMFallback <Boolean>]
[-ChosenAccount <String[]>]
[-ClearAccount]
[-EnableAutomaticClientPushInstallation <Boolean>]
[-EnableSystemTypeConfigurationManager <Boolean>]
[-EnableSystemTypeServer <Boolean>]
[-EnableSystemTypeWorkstation <Boolean>]
-InputObject <IResultObject>
[-InstallationProperty <String>]
[-InstallClientToDomainController <Boolean>]
[-RemoveAccount <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMClientPushInstallation
[-AddAccount <String[]>]
[-AllownNTLMFallback <Boolean>]
[-ChosenAccount <String[]>]
[-ClearAccount]
[-EnableAutomaticClientPushInstallation <Boolean>]
[-EnableSystemTypeConfigurationManager <Boolean>]
[-EnableSystemTypeServer <Boolean>]
[-EnableSystemTypeWorkstation <Boolean>]
-InputObject <IResultObject>
[-InstallationProperty <String>]
[-InstallClientToDomainController <Boolean>]
[-RemoveAccount <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMClientPushInstallation
[-AddAccount <String[]>]
[-AllownNTLMFallback <Boolean>]
[-ChosenAccount <String[]>]
[-ClearAccount]
[-EnableAutomaticClientPushInstallation <Boolean>]
[-EnableSystemTypeConfigurationManager <Boolean>]
[-EnableSystemTypeServer <Boolean>]
[-EnableSystemTypeWorkstation <Boolean>]
[-InstallationProperty <String>]
[-InstallClientToDomainController <Boolean>]
-Name <String>
[-RemoveAccount <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMClientPushInstallation
[-AddAccount <String[]>]
[-AllownNTLMFallback <Boolean>]
[-ChosenAccount <String[]>]
[-ClearAccount]
[-EnableAutomaticClientPushInstallation <Boolean>]
[-EnableSystemTypeConfigurationManager <Boolean>]
[-EnableSystemTypeServer <Boolean>]
[-EnableSystemTypeWorkstation <Boolean>]
[-InstallationProperty <String>]
[-InstallClientToDomainController <Boolean>]
[-RemoveAccount <String[]>]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 更改客户端请求安装的站点配置。 客户端请求安装方法在站点发现的计算机上安装 Configuration Manager 客户端。
还可以通过为集合中的特定集合或资源运行客户端请求安装向导来启动客户端请求安装。
有关详细信息，请参阅 如何在 Configuration Manager 中基于 Windows 的计算机上安装客户端。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：更改客户端请求安装的设置
此命令进行以下配置：
- 自动对发现的计算机使用客户端请求。
- 将客户端推送到站点系统服务器
- 站点使用名为 contoso\svc_smspush 的 帐户连接到计算机以安装客户端软件。
InstallationProperty 参数将 Windows Installer 包的 SMSSITECODE 属性的值设置为 CM1。 此设置将客户端分配到具有站点代码 CM1 的站点。
Set-CMClientPushInstallation -SiteCode "CM1" -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "contoso\svc_smspush" -InstallationProperty "SMSSITECODE=CM1"参数
-AddAccount
为可以安装客户端的一个或多个帐户指定字符串数组。 帐户必须是目标计算机上的本地 管理员 。 对于每个帐户，请使用格式 domain\username。
有关详细信息，请参阅 客户端请求安装帐户。
| 类型: | String[] |
| 别名: | AddAccounts |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllownNTLMFallback
当此参数$true时，如果站点无法使用 Kerberos 对客户端进行身份验证，它将使用 NTLM 重试连接。 提高安全性的建议配置是将此参数设置为 $false，这要求 Kerberos 不带 NTLM 回退。
注意
使用客户端请求安装 Configuration Manager 客户端时，站点服务器会创建与客户端的远程连接。 站点可以通过在建立连接之前不允许回退到 NTLM 来要求 Kerberos 相互身份验证。 此行为有助于保护服务器和客户端之间的通信。
根据安全策略，你的环境可能已经首选或要求 Kerberos 而不是旧版 NTLM 身份验证。 有关这些身份验证协议的安全注意事项的详细信息，请阅读 用于限制 NTLM 的 Windows 安全策略设置。
若要使用此功能，客户端必须位于受信任的 Active Directory 林中。 Windows 中的 Kerberos 依赖于 Active Directory 进行相互身份验证。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ChosenAccount
为已添加到 Configuration Manager 的一个或多个帐户指定字符串数组。
| 类型: | String[] |
| 别名: | ChosenAccounts |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ClearAccount
添加此参数可删除当前在站点上为客户端推送指定的所有帐户。 若要删除单个帐户，请使用 RemoveAccount 参数。
| 类型: | SwitchParameter |
| 别名: | ClearAccounts |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableAutomaticClientPushInstallation
将此参数设置为 $true ，以在新发现的计算机资源上安装 Configuration Manager 客户端。 它还允许在未安装客户端的现有计算机资源上进行安装。
如果将此参数设置为 $false，则仍可以在集合或设备上使用 “安装客户端 ”操作。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableSystemTypeConfigurationManager
将此参数设置为 $true ，以在站点系统服务器上安装 Configuration Manager 客户端。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableSystemTypeServer
将此参数设置为 $true ，以在服务器上安装 Configuration Manager 客户端。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableSystemTypeWorkstation
将此参数设置为 $true ，以在工作站上安装 Configuration Manager 客户端。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定客户端请求安装对象。 若要获取此对象，请使用 Get-CMClientPushInstallation cmdlet。
| 类型: | IResultObject |
| 别名: | ClientPushComponent |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-InstallationProperty
指定安装 Configuration Manager 客户端时要使用的任何安装属性。
例如：
/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSSITECODE="XYZ" SMSMP=mp01.contoso.com
有关详细信息，请参阅 关于 Configuration Manager 中的客户端安装参数和属性。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InstallClientToDomainController
设置此参数以指定是否在域控制器上安装 Configuration Manager 客户端：
- $true：始终在域控制器上安装客户端。
- $false：除非在客户端请求安装向导中指定，否则切勿在域控制器上安装客户端。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定客户端请求安装的名称。
| 类型: | String |
| 别名: | SiteName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RemoveAccount
指定要删除的客户端请求安装帐户的字符串数组。 若要删除所有帐户，请使用 ClearAccount 参数。
| 类型: | String[] |
| 别名: | RemoveAccounts |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteCode
指定三个字符的站点代码。 例如，XYZ。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject