リソースをパッケージ化してプル サーバーにアップロードする
以下のセクションでは、プル サーバーを既にセットアップしてあるものとします。 プル サーバーをセットアップしていない場合は、次のガイドを使用できます。
各ターゲット ノードは、構成やリソースをダウンロードし、さらにその状態を報告するように構成できます。 この記事では、ダウンロードできるようにリソースをアップロードする方法、およびリソースを自動的にダウンロードするようにクライアントを構成する方法を示します。 ノードは、割り当てられた構成をプルまたはプッシュ (v5) によって受け取ると、構成で必要なすべてのリソースを LCM で指定された場所から自動的にダウンロードします。
リソース モジュールをパッケージ化する
クライアントでダウンロードできる各リソースは、.zip
ファイルに格納する必要があります。 以下の例では、xPSDesiredStateConfiguration リソースを使用して必要な手順を示します。
Note
PowerShell 4.0 を使用しているクライアントがある場合は、リソース フォルダーの構造をフラット化し、すべてのバージョン フォルダーを削除する必要があります。 詳しくは、「Multiple Resource Versions (複数のリソース バージョン)」をご覧ください。
好みのユーティリティ、スクリプト、または方法を使って、リソース ディレクトリを圧縮することができます。 Windows の場合、xPSDesiredStateConfiguration
ディレクトリを "右クリック" して、 [送信先] 、 [圧縮フォルダー] の順に選択します。
リソース アーカイブの名前を指定する
リソース アーカイブには、次の形式で名前を付ける必要があります。
{ModuleName}_{Version}.zip
上の例では、xPSDesiredStateConfiguration.zip
の名前を xPSDesiredStateConfiguration_8.4.4.0.zip
に変更する必要があります。
チェックサムを作成する
リソース モジュールを圧縮して名前を変更した後は、チェックサムを作成する必要があります。 チェックサムは、クライアント上の LCM によって、リソースが変更されていて、再度ダウンロードする必要があるかどうかを判断するために使われます。 次の例で示すように、チェックサムは New-DSCCheckSum コマンドレットで作成できます。
New-DscChecksum -Path .\xPSDesiredStateConfiguration_8.4.4.0.zip
出力は示されませんが、"xPSDesiredStateConfiguration_8.4.4.0.zip.checksum" が表示されるようになるはずです。 また、-Path
パラメーターを使用すると、ファイルのディレクトリに対して New-DSCCheckSum
を実行することもできます。 チェックサムが既に存在する場合は、-Force
パラメーターを使用して強制的に再作成できます。
リソース アーカイブを格納する場所
DSC HTTP プル サーバー上
HTTP プル サーバーをセットアップするときは、「DSC HTTP プル サーバーを設定する」で説明されているように、ModulePath キーと ConfigurationPath キーに対するディレクトリを指定します。 ConfigurationPath キーは、".mof" ファイルを格納する必要がある場所を示します。 ModulePath は、DSC リソース モジュールを格納する必要がある場所を示します。
xDscWebService PSDSCPullServer
{
...
ModulePath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
ConfigurationPath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
...
}
SMB 共有上
ResourceRepositoryShare を指定した場合は、プル クライアントをセットアップするときに、ResourceRepositoryShare ブロックの SourcePath ディレクトリに、アーカイブとチェックサムを格納します。
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Configurations'
}
ResourceRepositoryShare SMBResourceServer
{
SourcePath = '\\SMBPullServer\Resources'
}
ConfigurationRepositoryShare だけを指定した場合は、プル クライアントをセットアップするときに、ConfigurationRepositoryShare ブロックの SourcePath ディレクトリに、アーカイブとチェックサムを格納します。
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Pull'
}
リソースの更新
アーカイブの名前のバージョン番号を変更するか、新しいチェックサムを作成することにより、強制的にノードにリソースを更新させることができます。 プル クライアントでは、LCM が更新されるときに、必要なリソースの新しいバージョンだけでなく更新されたチェックサムも確認されます。
参照
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示