New-DscChecksum
DSC ドキュメントと DSC リソースのチェックサム ファイルを作成します。
構文
Default (既定)
New-DscChecksum
[-Path] <String[]>
[[-OutPath] <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-DscChecksum コマンドレットは、PowerShell Desired State Configuration (DSC) ドキュメントと圧縮 DSC リソースのチェックサム ファイルを生成します。 このコマンドレットは、プル モードで使用する構成とリソースごとにチェックサム ファイルを生成します。 DSC サービスでは、チェックサムを使用して、ターゲット ノードに正しい構成とリソースが存在することを確認します。 関連付けられている DSC ドキュメントと圧縮された DSC リソースと共に、DSC サービス ストアにチェックサムを配置します。
例
例 1: 特定のパス内のすべての構成のチェックサム ファイルを作成する
PS C:\> New-DscChecksum -Path "C:\DSC\Configurations\"
このコマンドは、パス C:\DSC\Configurations内のすべての構成のチェックサム ファイルを作成します。
既に存在するチェックサム ファイルはすべてスキップされます。
例 2: 特定のパス内のすべての構成のチェックサム ファイルを作成する
PS C:\> New-DscChecksum -Path "C:\DSC\Configurations\" -Force
このコマンドは、パス C:\DSC\Configurations内のすべての構成に対して新しいチェックサム ファイルを作成します。
Force パラメーターを指定すると、コマンドは既に存在するすべてのチェックサム ファイルを上書きします。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
指定した出力ファイルが既に存在する場合、コマンドレットによって上書きされることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutPath
出力チェックサム ファイルのパスとファイル名を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
入力ファイルのパスを指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 構成パス |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | 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を参照してください。