Publish-DscConfiguration
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 |