PowerShell 5.0 以降での構成 ID を使用したプルクライアントのセットアップ

[アーティクル]
06/21/2023

適用先:Windows PowerShell 5.0

重要

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

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

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

Note

このトピックは、PowerShell 5.0 に適用されます。 PowerShell 4.0 でのプルクライアントのセットアップについては、「PowerShell 4.0 での構成 ID を使用したプルクライアントのセットアップ」をご覧ください。

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

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

構成を適用するには、Path をメタ構成 MOF ファイルの場所に設定して Set-DscLocalConfigurationManager コマンドレットを呼び出します。次に例を示します。

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

構成 ID

以下の例は、LCM の ConfigurationID プロパティをこの目的で以前に作成した Guid に設定します。 ConfigurationID は、LCM がプルサーバーで適切な構成を検索する場合に使用します。プルサーバー上の構成 MOF ファイルは、ConfigurationID.mof という名前にする必要があります。ここで、ConfigurationID はターゲットノードの LCM の ConfigurationID プロパティの値です。詳細については、プルサーバーへの構成の発行 (v4/v5)に関するページを参照してください。

以下の例を使用するか、または New-Guid コマンドレットを使用して、ランダムな Guid を作成できます。

[System.Guid]::NewGuid()

環境で Guid を使用する詳細については、Guid の計画に関する項を参照してください。

構成をダウンロードするようにプルクライアントをセットアップする

各クライアントをプルモードで構成し、その構成が格納されているプルサーバーの url を指定する必要があります。これを行うには、必要な情報を備えるようにローカル構成マネージャー (LCM) を構成する必要があります。 LCM を構成するには、DSCLocalConfigurationManager 属性で修飾された特別な種類の構成を作成します。 LCM の構成の詳細については、「ローカル構成マネージャーの構成」をご覧ください。

HTTP DSC プルサーバー

次のスクリプトは、"CONTOSO-PullSrv" という名前のサーバーから構成をプルするように LCM を構成します。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }
    }
}
PullClientConfigID

このスクリプトでは、ConfigurationRepositoryWeb ブロックでプルサーバーを定義しています。 ServerUrl は DSC プルの url を指定します

次のスクリプトは、SMB 共有 \\SMBPullServer\Pull から構成をプルするように LCM を構成します。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Pull'
        }
    }
}
PullClientConfigID

このスクリプトでは、ConfigurationRepositoryShare ブロックでプルサーバーを定義していますが、この例では、単なる SMB 共有です。

リソースをダウンロードするようにプルクライアントをセットアップする

LCM 構成で ConfigurationRepositoryWeb ブロックまたは ConfigurationRepositoryShare ブロックのみを指定した場合 (前の例はこれに当たります)、プルクライアントは、その構成を取得する同じ場所から、リソースをプルします。リソース用に別の場所を指定することもできます。リソースの場所を別のサーバーとして指定するには、ResourceRepositoryWeb ブロックを使用します。リソースの場所を SMB 共有として指定するには、ResourceRepositoryShare ブロックを使用します。

Note

ConfigurationRepositoryWeb を ResourceRepositoryShare と、または ConfigurationRepositoryShare を ResourceRepositoryWeb と組み合わせることができます。この例は、以下に示していません。

HTTP DSC プルサーバー

次のメタ構成は、プルクライアントが CONTOSO-PullSrv からその構成を取得し、CONTOSO-ResourceSrv からそのリソースを取得するように、プルクライアントを構成します。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

次の例は、SMB 共有 \\SMBPullServer\Configurations から構成を、SMB 共有 \\SMBPullServer\Resources からリソースをプルするように、クライアントをセットアップするメタ構成を示しています。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Configurations'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

プッシュモードでリソースを自動的にダウンロードする

PowerShell 5.0 以降では、プルクライアントは、プッシュ モードで構成されている場合でも、SMB 共有からモジュールをダウンロードできます。これは、プルサーバーをセットアップしないシナリオで特に便利です。 ResourceRepositoryShare ブロックは、ConfigurationRepositoryShare を指定しなくても使用できます。次の例に、SMB 共有 \\SMBPullServer\Resources からリソースをプルするようにクライアントをセットアップするメタ構成を示します。ノードに構成がプッシュされると、指定された共有から必要なすべてのリソースが自動的にダウンロードされます。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

状態を報告するようにプルクライアントをセットアップする

既定では、ノードは構成済みプルサーバーにレポートを送信しません。構成、リソース、およびレポートについて単一のプルサーバーを使うことができますが、レポートをセットアップするために ReportRepositoryWeb ブロックを作成する必要があります。

HTTP DSC プルサーバー

次の例は、単一のプルサーバーに対して構成とリソースをプルし、レポートデータを送信するようにクライアントを設定するメタ構成を示しています。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

レポートサーバーを指定するには、ReportRepositoryWeb ブロックを使用します。レポートサーバーを SMB サーバーにすることはできません。次のメタ構成は、CONTOSO-PullSrv から構成を取得し、CONTOSO-ResourceSrv からリソースを取得し、CONTOSO-ReportSrv に状態レポートを送信するように、プルクライアントを構成します。

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-ReportSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

レポートサーバーを SMB 共有にすることはできません。

次の手順

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

参照

構成名を使用したプルクライアントのセットアップ

PowerShell 5.0 以降での構成 ID を使用したプル クライアントのセットアップ

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

構成 ID

構成をダウンロードするようにプル クライアントをセットアップする

HTTP DSC プル サーバー

SMB 共有

リソースをダウンロードするようにプル クライアントをセットアップする

HTTP DSC プル サーバー

SMB 共有

プッシュ モードでリソースを自動的にダウンロードする

状態を報告するようにプル クライアントをセットアップする

HTTP DSC プル サーバー

SMB 共有

次の手順

参照

フィードバック

その他のリソース

PowerShell 5.0 以降での構成 ID を使用したプルクライアントのセットアップ

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

構成をダウンロードするようにプルクライアントをセットアップする

HTTP DSC プルサーバー

リソースをダウンロードするようにプルクライアントをセットアップする

HTTP DSC プルサーバー

プッシュモードでリソースを自動的にダウンロードする

状態を報告するようにプルクライアントをセットアップする

HTTP DSC プルサーバー