Set-DscLocalConfigurationManager

モジュール:

PSDesiredStateConfiguration

ローカル Configuration Manager (LCM) 設定をノードに適用します。

構文

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

コマンドレットは Set-DscLocalConfigurationManager 、LCM 設定 (メタ構成) をノードに適用します。 コンピューターの名前を指定するか、または Common Information Model (CIM) セッションを使用してコンピューターを指定します。 ターゲット コンピューターを指定しない場合、コマンドレットは、ローカル コンピューターに設定を適用します。

例

例 1: LCM 設定を適用する

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

このコマンドは、 から C:\DSC\Configurations\ ターゲットノードに LCM 設定を適用します。 設定を受信すると、LCM によって処理されます。

警告

指定したフォルダーに格納されている同じコンピューターに対して複数のメタ mof がある場合は、最初の meta mof のみが適用されます。

例 2: CIM セッションを使用して LCM 設定を適用する

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session

この例では、LCM 設定をコンピューターに適用し、設定を適用します。 例では、コマンドレットで使用するために、Server01 という名前のコンピューター用に CIM セッションを作成します。 または、CIM セッションの配列を作成して、指定した複数のコンピューターにコマンドレットを適用します。

最初のコマンドは、 コマンドレットを使用して CIM セッションを New-CimSession 作成し、 CimSession オブジェクトを $Session 変数に格納します。 コマンドはパスワードの入力をユーザーに求めます。 詳細を表示するには「Get-Help New-CimSession」を入力します。

2 番目のコマンドは、 から C:\DSC\Configurations\ 対象ノードの LCM 設定を、 変数に格納されている CimSession オブジェクトによって識別されるコンピューターに $Session 適用します。 この例では、変数には $Session Server01 という名前のコンピューターに対してのみ CIM セッションが含まれています。 コマンドは設定を適用します。 設定を受信すると、LCM によって処理されます。

パラメーター

-CimSession

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 コンピューター名またはセッション オブジェクト ( New-CimSession または Get-CimSession コマンドレットの出力など) を入力します。 既定値は、ローカル コンピューターで実行中の現在のセッションです。

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

コンピューター名の配列を指定します。 このパラメーターは、 Path パラメーターにメタ構成ドキュメントがあるコンピューターを、配列で指定されたコンピューターに制限します。

Type:	String[]
Aliases:	CN, ServerName
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Credential

ターゲット コンピューターに対して、ユーザー名とパスワードを、PSCredential オブジェクトとして指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細を表示するには「Get-Help Get-Credential」を入力します。

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-Path

構成設定ファイルを含むフォルダーのファイル パスを指定します。 コマンドレットは、これらの LCM 設定を発行し、指定したパスに設定ファイルがあるコンピューターに適用します。 各ターゲット ノードには、次の形式の設定ファイルが必要です。 NetBIOS Name.meta.mof

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottleLimit

コマンドレットを実行するために確立できる最大並行処理数を指定します。 このパラメーターを省略するか、 の0値を入力した場合、Windows PowerShellは、コンピューターで実行されている CIM コマンドレットの数に基づいて、コマンドレットの最適なスロットル制限を計算します。 調整限度は、現在のコマンドレットのみに適用されます。セッションやコンピューターには適用されません。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

関連リンク

• Windows PowerShell Desired State Configuration の概要
• Get-DscLocalConfigurationManager