Set-DscLocalConfigurationManager
ローカル 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 |