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

説明

クライアント プッシュ インストールのサイト構成を変更するには、このコマンドレットを使用します。 クライアント プッシュ インストール方法は、サイトが検出したコンピューターに Configuration Manager クライアントをインストールします。

コレクション内の特定のコレクションまたはリソースに対してクライアント プッシュ インストール ウィザードを実行して、クライアント プッシュ インストールを開始することもできます。

詳細については、「 Configuration Manager で Windows ベースのコンピューターにクライアントをインストールする方法」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: クライアント プッシュ インストールの設定を変更する

このコマンドは、次の構成を行います。

  • 検出されたコンピューターに対してクライアント プッシュを自動的に使用します。
  • クライアントをサイト システム サーバーにプッシュする
  • サイトでは、 contoso\svc_smspush という名前のアカウントを使用してコンピューターに接続し、クライアント ソフトウェアをインストールします。

InstallationProperty パラメーターは、Windows インストーラー パッケージの SMSSITECODE プロパティの値を CM1 に設定します。 この設定は、サイト コード CM1 を持つサイトにクライアントを割り当てます。

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

パラメーター

-AddAccount

クライアントをインストールできる 1 つ以上のアカウントの文字列配列を指定します。 アカウントは、移行先コンピューターのローカル 管理者 である必要があります。 アカウントごとに、 domain\username形式を使用します。

詳細については、「 クライアント プッシュ インストール アカウント」を参照してください。

型:String[]
Aliases:AddAccounts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AllownNTLMFallback

このパラメーターを $trueすると、サイトが Kerberos を使用してクライアントを認証できない場合は、NTLM を使用して接続を再試行します。 セキュリティを強化するために推奨される構成は、このパラメーターを $false に設定することです。このパラメーターには NTLM フォールバックのない Kerberos が必要です。

注:

クライアント プッシュを使用して Configuration Manager クライアントをインストールすると、サイト サーバーによってクライアントへのリモート接続が作成されます。 サイトでは、接続を確立する前に NTLM へのフォールバックを許可しないことで、Kerberos の相互認証を必要とできます。 この動作は、サーバーとクライアント間の通信をセキュリティで保護するのに役立ちます。

セキュリティ ポリシーによっては、お使いの環境で、以前の NTLM 認証よりも Kerberos が既に優先または必要な場合があります。 これらの認証プロトコルのセキュリティに関する考慮事項の詳細については、 NTLM を制限する Windows セキュリティ ポリシー設定に関するページを参照してください。

この機能を使用するには、クライアントが信頼された Active Directory フォレストに存在する必要があります。 Windows の Kerberos は、相互認証に Active Directory に依存しています。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ChosenAccount

Configuration Manager に既に追加されている 1 つ以上のアカウントの文字列配列を指定します。

型:String[]
Aliases:ChosenAccounts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClearAccount

このパラメーターを追加して、サイトでクライアント プッシュ用に現在指定されているすべてのアカウントを削除します。 1 つのアカウントを削除するには、 RemoveAccount パラメーターを使用します。

型:SwitchParameter
Aliases:ClearAccounts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableAutomaticClientPushInstallation

新しく検出されたコンピューター リソースに Configuration Manager クライアントをインストールするには、このパラメーターを $true に設定します。 また、クライアントがインストールされていない既存のコンピューター リソースへのインストールも可能になります。

このパラメーターを $false に設定した場合でも、コレクションまたはデバイスで クライアントのインストール アクションを使用できます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableSystemTypeConfigurationManager

Configuration Manager クライアントをサイト システム サーバーにインストールするには、このパラメーターを $true に設定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableSystemTypeServer

Configuration Manager クライアントをサーバーにインストールするには、このパラメーターを $true に設定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableSystemTypeWorkstation

このパラメーターを $true に設定して、Configuration Manager クライアントをワークステーションにインストールします。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

クライアント プッシュ インストール オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMClientPushInstallation コマンドレットを 使用します。

型:IResultObject
Aliases:ClientPushComponent
配置: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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstallClientToDomainController

ドメイン コントローラーに Configuration Manager クライアントをインストールするかどうかを指定するには、このパラメーターを設定します。

  • $true: クライアントは常にドメイン コントローラーにインストールします。
  • $false: クライアント プッシュ インストール ウィザードで指定されていない限り、ドメイン コントローラーにクライアントをインストールしないでください。
型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

クライアント プッシュ インストールの名前を指定します。

型:String
Aliases:SiteName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveAccount

削除するクライアント プッシュ インストール アカウントの文字列配列を指定します。 すべてのアカウントを削除するには、 ClearAccount パラメーターを使用します。

型:String[]
Aliases:RemoveAccounts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SiteCode

3 文字のサイト コードを指定します。 たとえば、「 XYZ 」のように入力します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject