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) 構成ドキュメントを発行します。 このコマンドレットは、構成を適用しません。 構成は、 useExisting パラメーターと共に使用される場合、または DSC エンジンがその整合性サイクルを実行するときに、Start-DscConfiguration コマンドレットによって適用されます。 DSC エンジンは、ローカル Configuration Manager (LCM) とも呼ばれます。

このコマンドレットは、複数の構成ドキュメントのフラグメントが配信される場合に特に便利です。 複数の構成ドキュメント フラグメントが配信されると、古い構成ドキュメント フラグメントが上書きされます。

例

例 1: リモート コンピューターに構成を発行する

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

このコマンドは、リモート コンピューターに構成を発行します。 コマンドレットを実行するユーザーは、リモート コンピューターの管理者である必要があります。

パラメーター

-CimSession

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

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

-ComputerName

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

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

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

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

-Force

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

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

-Path

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

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