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参数将安装程序程序包的SMSSITECODE Windows CM1 的值。 此设置将客户端分配给站点代码为 CM1 的站点

Set-CMClientPushInstallation -SiteCode "CM1" -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "contoso\svc_smspush" -InstallationProperty "SMSSITECODE=CM1"

参数

-AddAccount

为可以安装客户端的一个或多个帐户指定字符串数组。 帐户需为 目标计算机上本地 管理员。 对于每个帐户,请使用格式 domain\username

有关详细信息,请参阅客户端 推送安装帐户

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

-AllownNTLMFallback

此参数$true时,如果站点无法通过使用 Kerberos 对客户端进行身份验证,它将使用 NTLM 重试连接。 用于提高安全性的建议配置是,将此参数设置为 $false,这需要没有 NTLM 回退的 Kerberos。

备注

当站点服务器使用客户端推送来安装 Configuration Manager 客户端时,会创建与客户端的远程连接。 站点可以通过在建立连接之前不允许回退到 NTLM 来要求 Kerberos 相互身份验证。 此行为有助于保护服务器和客户端之间的通信安全。

根据安全策略,您的环境可能已首选或需要 Kerberos,而不需要旧的 NTLM 身份验证。 有关这些身份验证协议的安全注意事项详细信息,请阅读有关限制Windows NTLM 的安全策略设置

若要使用此功能,客户端必须位于受信任的 Active Directory 林中。 Kerberos Windows Active Directory 进行相互身份验证。

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

-ChosenAccount

为已添加到 Configuration Manager 的一个或多个帐户指定字符串数组。

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

-ClearAccount

添加此参数可删除当前为站点中的客户端推送指定的所有帐户。 若要删除单个帐户,请使用 RemoveAccount 参数。

Type:SwitchParameter
Aliases:ClearAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用

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

-EnableAutomaticClientPushInstallation

设置此参数 $true 新发现的计算机资源上安装 Configuration Manager 客户端。 它还支持在未安装客户端的现有计算机资源上安装。

如果此参数设置为 $false,则仍可在集合或设备上使用 Install 客户端操作。

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

-EnableSystemTypeConfigurationManager

设置此参数 $true 以在站点系统服务器上安装 Configuration Manager 客户端。

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

-EnableSystemTypeServer

设置此参数 $true 以将 Configuration Manager 客户端安装到服务器上。

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

-EnableSystemTypeWorkstation

设置此参数 $true 在工作站上安装 Configuration Manager 客户端。

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

-ForceWildcardHandling

此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用

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

-InputObject

指定客户端推送安装对象。 若要获取此对象,请使用 Get-CMClientPushInstallation cmdlet。

Type:IResultObject
Aliases:ClientPushComponent
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 中的客户端安装参数和属性

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

-InstallClientToDomainController

设置此参数以指定是否在域控制器上安装 Configuration Manager 客户端:

  • $true: 始终在域控制器上安装客户端。
  • $false: 除非在客户端推送安装向导中指定,否则切勿在域控制器上安装客户端。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAccount

指定要删除的客户端推送安装帐户的字符串数组。 若要删除所有帐户,请使用 ClearAccount 参数。

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

-SiteCode

指定三个字符的网站代码。 例如,XYZ

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-名称

指定客户端推送安装的名称。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject