Set-DscLocalConfigurationManager
ローカル構成マネージャー (LCM) 設定をノードに適用します。
構文
ComputerNameSet (既定)
Set-DscLocalConfigurationManager
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Set-DscLocalConfigurationManager
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-DscLocalConfigurationManager コマンドレットは、LCM 設定 (メタ構成) をノードに適用します。 コンピューター名を指定するか、共通情報モデル (CIM) セッションを使用して、コンピューターを指定します。 ターゲット コンピューターを指定しない場合、コマンドレットはローカル コンピューターに設定を適用します。
例
例 1: LCM 設定を適用する
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"
このコマンドは、C:\DSC\Configurations\ からターゲット ノードに LCM 設定を適用します。 設定を受け取った後、LCM はそれらを処理します。
Warnung
指定したフォルダーに格納されている同じコンピューターに対して複数のメタ mof がある場合は、最初のメタ mof のみが適用されます。
例 2: CIM セッションを使用して LCM 設定を適用する
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session
この例では、LCM 設定をコンピューターに適用し、設定を適用します。 この例では、コマンドレットで使用する Server01 という名前のコンピューターの CIM セッションを作成します。 または、CIM セッションの配列を作成して、指定された複数のコンピューターにコマンドレットを適用します。
最初のコマンドは、New-CimSession コマンドレットを使用して CIM セッションを作成し、CimSession オブジェクトを $Session 変数に格納します。 コマンドによってパスワードの入力が求められます。 詳細については、「Get-Help New-CimSession」と入力します。
2 番目のコマンドは、C:\DSC\Configurations\ からターゲット ノードの LCM 設定を、 変数に格納されている $Session オブジェクトによって識別されるコンピューターに適用します。 この例では、$Session 変数には、Server01 という名前のコンピューターに対してのみ CIM セッションが含まれています。 このコマンドは設定を適用します。 設定を受け取った後、LCM はそれらを処理します。
パラメーター
-CimSession
リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 New-CimSession の出力や Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクト 入力します。 既定値は、ローカル コンピューター上の現在のセッションです。
パラメーターのプロパティ
| 型: | |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CimSessionSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ComputerName
コンピューター名の配列を指定します。 このパラメーターは、Path パラメーターにメタ構成ドキュメントがあるコンピューターを、配列で指定されたコンピューターに制限します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | CN, サーバー名 |
パラメーター セット
ComputerNameSet
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
ターゲット コンピューターの PSCredential オブジェクト Get-Help Get-Credential」と入力します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ComputerNameSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
構成設定ファイルを含むフォルダーのファイル パスを指定します。 コマンドレットは、これらの LCM 設定を発行し、指定されたパスに設定ファイルがあるコンピューターに適用します。 各ターゲット ノードには、次の形式の設定ファイルが必要です: NetBIOS Name.meta.mof。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ThrottleLimit
コマンドレットを実行するために確立できる同時実行操作の最大数を指定します。 このパラメーターを省略するか、0 の値を入力すると、Windows PowerShell は、コンピューターで実行されている CIM コマンドレットの数に基づいて、コマンドレットの最適なスロットル制限を計算します。 スロットル制限は、セッションまたはコンピューターではなく、現在のコマンドレットにのみ適用されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
