Set-CMClientPushInstallation

設定用戶端推入安裝的設定。

Syntax

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>]

Description

使用此 Cmdlet 來變更用戶端推入安裝的網站設定。 用戶端推入安裝方法會在網站探索的電腦上安裝 Configuration Manager 用戶端。

您也可以對集合中的特定集合或資源執行用戶端推入安裝精靈,以啟動用戶端推入安裝。

如需詳細資訊,請參閱如何在 Configuration Manager 的 Windows 型電腦上安裝用戶端

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:變更用戶端推入安裝的設定

這個命令會進行下列設定:

  • 自動為探索的電腦使用用戶端推送。
  • 將用戶端推送至網站系統伺服器
  • 網站使用名為 contoso \ svc_smspush 的帳戶連接至電腦,以安裝用戶端軟體。

InstallationProperty參數會將 Windows Installer 套件的SMSSITECODE屬性值設為CM1。 此設定會將用戶端指派至具有 site code 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,這需要 Kerberos,但不需要 NTLM 回退。

注意

當它使用用戶端推入安裝 Configuration Manager 用戶端時,網站伺服器會建立與用戶端的遠端連線。 網站可以要求 Kerberos 相互驗證,但不允許在建立連線之前回退到 NTLM。 這種行為可協助保護伺服器與用戶端之間的通訊安全。

根據您的安全性原則,您的環境可能已優先使用或要求 Kerberos over 舊版 NTLM 驗證。 如需這些驗證通訊協定的安全性考慮的詳細資訊,請參閱Windows 的安全性原則設定以限制 NTLM

若要使用此功能,用戶端必須位於受信任的 Active Directory 樹系中。 Windows 中的 Kerberos 依賴 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,您仍然可以在集合或裝置上使用 [ 安裝用戶端 ] 動作。

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

指定用戶端推入安裝物件。 若要取得此物件,請使用 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

輸入

ConfigurationManagement IResultObject