次の方法で共有

Publish-DscConfiguration

  • リファレンス
モジュール:
PSDesiredStateConfiguration

DSC 構成を一連のコンピューターに発行します。

構文

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-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[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ComputerName

このコマンドレットが構成を発行するコンピューターを 1 つ以上指定します。

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

-Confirm

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

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

-Credential

ターゲット デバイスへのアクセスに使用する資格情報を指定します。

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

-Force

コマンドレットを強制的に終了します。 ローカル構成マネージャーの更新モードが PULL に設定されている場合、このパラメーターを使用すると PUSH に変更され、DSC 構成の公開が有効になります。 また、保留中の DSC 構成が存在する場合は、このパラメーターを使用すると、その保留中の構成が上書きされます。

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

-Path

ターゲット コンピューターに発行する構成を含むパスを指定します。

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

-ThrottleLimit

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

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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