次の方法で共有

PowerShell 4.0 での LCM の構成

適用対象: Windows PowerShell 4.0

Windows PowerShell 5.0 以降の詳細については、「 ローカル構成マネージャーの構成」を参照してください。

ローカル構成マネージャーは、Windows PowerShell の Desired State Configuration (DSC) エンジンです。 これはすべてのターゲットノードで実行され、DSC 構成スクリプトに含まれる構成リソースを呼び出します。 このトピックでは、ローカル構成マネージャーのプロパティの一覧と、ターゲット ノードのローカル構成マネージャーの設定を変更する方法について説明します。

ローカル構成マネージャーのプロパティ

次に、設定または取得できるローカル構成マネージャーのプロパティを示します。

  • AllowModuleOverwrite: 構成サービスからダウンロードされた新しい構成が、ターゲット・ノード上の古い構成を上書きできるかどうかを制御します。 指定できる値は True と False です。
  • CertificateID: 構成で渡された資格情報をセキュリティで保護するために使用される証明書の拇印。 詳細については、「 Windows PowerShell の望ましい状態構成で資格情報をセキュリティで保護しますか?」を参照してください。
  • ConfigurationID: プル サービスから特定の構成ファイルを取得するために使用される GUID を示します。 GUID は、正しい構成ファイルに確実にアクセスできるようにします。
  • ConfigurationMode: ローカル構成マネージャーがターゲット ノードに実際に構成を適用する方法を指定します。 次の値を取ることができます。
    • ApplyOnly: このオプションを使用すると、DSC は構成を適用し、新しい構成をターゲット ノードに直接送信するか、プル サービスに接続していて DSC がプル サービスで確認するときに新しい構成を検出する場合に、新しい構成が検出されない限り、それ以上は何もしません。 ターゲットノードの設定がドリフトした場合、アクションは実行されません。
    • ApplyAndMonitor: このオプション (デフォルト) を使用すると、DSC は、ユーザーがターゲット ノードに直接送信したか、プル サービスで検出されたかにかかわらず、新しい構成を適用します。 その後、ターゲットノードの設定が設定ファイルから逸脱した場合、DSC はログで不一致を報告します。 DSC ログの詳細については、「 イベント ログを使用した Desired State Configuration のエラーの診断」を参照してください。
    • ApplyAndAutoCorrect: このオプションを使用すると、DSC は、ユーザーがターゲット ノードに直接送信したか、プル サービスで検出されたかにかかわらず、新しい構成を適用します。 その後、ターゲットノードの設定が設定ファイルから逸脱した場合、DSC はログの不一致を報告し、設定ファイルに準拠するようにターゲットノードの設定を調整しようとします。
  • ConfigurationModeFrequencyMins: DSC のバックグラウンド アプリケーションがターゲット ノードで現在の構成を実装しようとする頻度 (分単位) を表します。 既定値は 15 です。 この値は、RefreshMode と組み合わせて設定できます。 RefreshMode が PULL に設定されている場合、ターゲット ノードは RefreshFrequencyMins によって設定された間隔で構成サービスに接続し、現在の構成をダウンロードします。 RefreshMode 値に関係なく、ConfigurationModeFrequencyMins で設定された間隔で、整合性エンジンは、ダウンロードされた最新の構成をターゲット ノードに適用します。 RefreshFrequencyMins は、ConfigurationModeFrequencyMins の整数倍に設定する必要があります。
  • 資格情報: 構成サービスに接続するなど、リモート リソースにアクセスするために必要な資格情報 (Get-Credentialと同様) を示します。
  • DownloadManagerCustomData: ダウンロード マネージャーに固有のカスタム データを含む配列を表します。
  • DownloadManagerName: 構成およびモジュールのダウンロードマネージャーの名前を示します。
  • RebootNodeIfNeeded: リソースが$global:DSCMachineStatusフラグを使用してノードを再起動できるようにするには、これを$trueに設定します。 それ以外の場合は、必要な構成に対してノードを手動で再起動する必要があります。 既定値は $false です。 再起動条件が DSC 以外のもの (Windows インストーラーなど) によって実行されるときにこの設定を使用するには、この設定を xPendingReboot モジュールと組み合わせます。
  • RefreshFrequencyMins: プル サービスを設定した場合に使用されます。 ローカル構成マネージャーがプル サービスに接続して現在の構成をダウンロードする頻度 (分単位) を表します。 この値は、ConfigurationModeFrequencyMins と組み合わせて設定できます。 RefreshMode が PULL に設定されている場合、ターゲット ノードは RefreshFrequencyMins によって設定された間隔でプル サービスに接続し、現在の構成をダウンロードします。 ConfigurationModeFrequencyMins で設定された間隔で、整合性エンジンは、ダウンロードされた最新の構成をターゲット ノードに適用します。 RefreshFrequencyMins が ConfigurationModeFrequencyMins の整数倍に設定されていない場合、システムはそれを切り上げます。 既定値は 30 です。
  • RefreshMode: 指定できる値は 、Push (デフォルト) と Pull です。 「プッシュ」構成では、任意のクライアント コンピューターを使用して、各ターゲット ノードに構成ファイルを配置する必要があります。 "プル" モードでは、ローカル構成マネージャーが構成ファイルに接続してアクセスするためのプル サービスをセットアップする必要があります。

注

LCM は、以下に基づいて ConfigurationModeFrequencyMins サイクルを開始します。

  • 新しいメタ構成は、 Set-DscLocalConfigurationManager
  • マシンの再起動

タイマー プロセスでクラッシュが発生する状況では、30 秒以内に検出され、サイクルが再開されます。 同時操作によりサイクルの開始が遅れる可能性があり、この操作の期間が構成されたサイクル頻度を超えると、次のタイマーは開始されません。

たとえば、メタ構成は 15 分のプル頻度で構成され、プルは T1 で発生します。 ノードは 16 分間作業を完了しません。 最初の15分サイクルは無視され、次のプルはT1 + 15 + 15で発生します。

ローカル構成マネージャー設定の更新例

次の例に示すように、構成スクリプトのノード ブロック内に LocalConfigurationManager ブロックを含めることで、ターゲット ノードのローカル構成マネージャー設定を更新できます。

Configuration ExampleConfig
{
    Node "Server001"
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called
# Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

前の例のスクリプトを実行すると、目的の設定を指定して格納する MOF ファイルが生成されます。 設定を適用するには、次の例に示すように、 Set-DscLocalConfigurationManager コマンドレットを使用できます。

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

注

Path パラメータには、前の例で設定を呼び出したときに OutputPath パラメータに指定したのと同じパスを指定する必要があります。

現在のローカル Configuration Manager 設定を表示するには、 Get-DscLocalConfigurationManager コマンドレットを使用できます。 パラメーターなしでこのコマンドレットを呼び出すと、既定では、実行するノードのローカル構成マネージャー設定が取得されます。 別のノードを指定するには、このコマンドレットで CimSession パラメーターを使用します。

  • Last updated on