Publish-DscConfiguration
構文
ComputerNameSet (既定)
Publish-DscConfiguration
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Publish-DscConfiguration
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Publish-DscConfiguration コマンドレットは、一連のコンピューターに Windows PowerShell Desired State Configuration (DSC) 構成ドキュメントを発行します。 このコマンドレットでは、構成は適用されません。
構成は、Start-DscConfiguration コマンドレットが UseExisting パラメーターと共に使用される場合、または DSC エンジンがその整合性サイクルを実行するときに適用されます。 DSC エンジンは、ローカル構成マネージャー (LCM) とも呼ばれます。
このコマンドレットは、複数の構成ドキュメントのフラグメントが配信される場合に特に便利です。
複数の構成ドキュメント フラグメントが配信されると、古い構成ドキュメント フラグメントが上書きされます。
例
例 1: リモート コンピューターに構成を発行する
Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)
このコマンドは、構成をリモート コンピューターに発行します。 コマンドレットを実行するユーザーは、リモート コンピューターの管理者である必要があります。
パラメーター
-CimSession
リモート セッションまたはリモート コンピューターでコマンドレットを実行します。
New-CimSession の出力や Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクト 入力します。 既定値は、ローカル コンピューター上の現在のセッションです。
パラメーターのプロパティ
| 型: | CimSession[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CimSessionSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ComputerName
このコマンドレットが構成を発行するコンピューターを 1 つ以上指定します。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | CN, サーバー名 |
パラメーター セット
ComputerNameSet
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
ターゲット デバイスへのアクセスに使用する資格情報を指定します。
パラメーターのプロパティ
パラメーター セット
ComputerNameSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
コマンドレットを強制的に終了します。 ローカル構成マネージャーの更新モードが PULL に設定されている場合、このパラメーターを使用すると PUSH に変更され、DSC 構成の公開が有効になります。 また、保留中の DSC 構成が存在する場合は、このパラメーターを使用すると、その保留中の構成が上書きされます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
ターゲット コンピューターに発行する構成を含むパスを指定します。
パラメーターのプロパティ
| 型: | 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を参照してください。
