PowerShell 4.0 で構成 ID を使用してプル クライアントを設定する

適用対象: Windows PowerShell 4.0、Windows PowerShell 5.0

Important

プル サーバー (Windows 機能 DSC-Service) は Windows Server のサポートされているコンポーネントですが、新しい機能を提供する予定はありません。 新しいバージョンの DSC が一般提供され、 ゲスト構成という名前の Azure Policy の機能によって管理されることをお知らせします。 ゲスト構成サービスは、DSC 拡張機能、Azure Automation State Configuration、およびお客様からのフィードバックから最も要望の多かった機能を組み合わせたものです。 ゲスト構成には、 Arc 対応サーバーを介したハイブリッド マシンのサポートも含まれます。

プルクライアントを設定する前に、プルサーバーを設定する必要があります。 この順序は必須ではありませんが、トラブルシューティングに役立ち、登録が成功したことを確認するのに役立ちます。 プルサーバーを設定するには、次のガイドを使用できます。

各ターゲットノードは、構成やリソースをダウンロードし、そのステータスを報告するように構成できます。 以下のセクションでは、SMB 共有または HTTP DSC プル サーバーを使用してプル クライアントを構成する方法を示します。 ノードのLCMが更新されると、設定された場所に到達して、割り当てられた設定をダウンロードします。 必要なリソースがノードに存在しない場合は、設定された場所から自動的にダウンロードされます。 ノードが レポート サーバーで構成されている場合は、操作の状態が報告されます。

プル クライアント LCM を構成する

以下の例のいずれかを実行すると、 PullClientConfigID という名前の新しい出力フォルダーが作成され、そこにメタ構成 MOF ファイルが配置されます。 この場合、メタ構成 MOF ファイルの名前は localhost.meta.mof になります。

構成を適用するには、 Set-DscLocalConfigurationManager コマンドレットを呼び出し、 パスを メタ構成 MOF ファイルの場所に設定します。 例えば次が挙げられます。

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.

構成 ID

次の例では、LCM の ConfigurationID プロパティを、この目的のために以前に作成された Guid に設定します。 ConfigurationID は、LCM がプル サーバーで適切な構成を見つけるために使用するものです。 プル サーバー上の構成 MOF ファイルには ConfigurationID.mof という名前を付ける必要があります。ここで、 ConfigurationID はターゲット ノードの LCM の ConfigurationID プロパティの値です。 詳細については、「 プル・サーバーへの構成の公開 (v4/v5)」を参照してください。

以下の例を使用して、ランダムな Guid を作成できます。

[System.Guid]::NewGuid()

構成をダウンロードするためのプルクライアントの設定

各クライアントは プル モードで設定し、その設定が格納されているプルサーバーURLを指定する必要があります。 これを行うには、必要な情報を使用してローカル構成マネージャー (LCM) を構成する必要があります。 LCM を構成するには、 LocalConfigurationManager ブロックを使用して特別な種類の構成を作成します。 LCM の構成の詳細については、「 ローカル構成マネージャーの構成」を参照してください。

HTTP DSC プル サーバー

プル サーバーが Web サービスとして設定されている場合は、 DownloadManagerName を WebDownloadManager に設定します。 WebDownloadManager では、DownloadManagerCustomData キーに ServerUrl を指定する必要があります。 次の例のように、 AllowUnsecureConnection の値を指定することもできます。 次のスクリプトは、"PullServer" という名前のサーバーから構成をプルするように LCM を構成します。

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24"
        RefreshMode = "PULL"
        DownloadManagerName = "WebDownloadManager"
        RebootNodeIfNeeded = $true
        RefreshFrequencyMins = 30
        ConfigurationModeFrequencyMins = 30
        ConfigurationMode = "ApplyAndAutoCorrect"
        DownloadManagerCustomData = @{
            ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"
            AllowUnsecureConnection = "TRUE"
        }
    }
}
PullClientConfigId -Output "."

SMBシェア

プル サーバーが Web サービスではなく SMB ファイル共有として設定されている場合は、DownloadManagerName を WebDownLoadManager ではなく DscFileDownloadManager に設定します。 DscFileDownloadManager では、DownloadManagerCustomData に SourcePath プロパティを指定する必要があります。 次のスクリプトは、"CONTOSO-SERVER" という名前のサーバー上の "SmbDscShare" という名前の SMB 共有から構成をプルするように LCM を構成します。

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

次のステップ

プルクライアントが構成されたら、次のガイドを使用して次の手順を実行できます。

こちらもご覧ください