Windows 用 Desired State Configuration (DSC) の概要

この記事では、Windows 用 PowerShell Desired State Configuration (DSC) の使用を開始する方法について説明します。 DSC に関する一般的な情報については、「Windows PowerShell Desired State Configuration の概要」を参照してください。

サポート対象の Windows オペレーティング システムのバージョン

次のバージョンがサポートされています。

• Windows Server 2022
• Windows Server 2019
• Windows Server 2016
• Windows 11
• Windows 10

Microsoft Hyper-V Server スタンドアロン製品には Desired State Configuration の実装が含まれていないため、PowerShell DSC またはAzure Automation State Configurationを使用して管理することはできません。

DSC のインストール

PowerShell Desired State Configuration は Windows に含まれており、Windows Management Framework を通じて更新されます。 最新バージョンは Windows Management Framework 5.1 です。

注意

DSC を使用してマシンを管理するために、Windows Server 機能 'DSC-Service' を有効にする必要はありません。 この機能は、Windows プル サーバー インスタンスを構築する場合にのみ必要です。

Windows 用 DSC の使用

次のセクションでは、Windows コンピューター上で DSC 構成を作成し、実行する方法を説明します。

構成 MOF ドキュメントの作成

構成を作成するには、Windows PowerShell の Configuration キーワードを使用します。 以下の手順では、Windows PowerShell を使って構成ドキュメントを作成する方法について説明します。

DSC リソースを含むモジュールをインストールする

Windows PowerShell Desired State Configuration には、DSC リソースを含んだ組み込みモジュールが含まれています。 PowerShellGet コマンドレットを使って、PowerShell ギャラリーなどの外部ソースからモジュールを読み込むこともできます。

Install-Module 'PSDscResources' -Verbose

構成を定義し、構成ドキュメントを生成します。

Configuration EnvironmentVariable_Path
{
    param ()

    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost
    {
        Environment CreatePathEnvironmentVariable
        {
            Name = 'TestPathEnvironmentVariable'
            Value = 'TestValue'
            Ensure = 'Present'
            Path = $true
            Target = @('Process', 'Machine')
        }
    }
}

EnvironmentVariable_Path -OutputPath:"./EnvironmentVariable_Path"

構成をコンピューターに適用する

注意

DSC が実行できるようにするには、localhost の構成を実行している場合でも PowerShell のリモート コマンドを受信するように、Windows を構成する必要があります。 環境を正しく構成するには、管理者特権の PowerShell ターミナルで行います Set-WsManQuickConfig -Force 。

Start-DscConfiguration コマンドレットを使用して、構成ドキュメント (MOF ファイル) をコンピューターに適用できます。

Start-DscConfiguration -Path 'C:\EnvironmentVariable_Path' -Wait -Verbose

構成の現在の状態を取得する

Get-DscConfiguration コマンドレットを使うと、コンピューターの現在の状態が照会され、構成の現在の値が返されます。

Get-DscConfiguration

Get-DscLocalConfigurationManager コマンドレットを使うと、コンピューターに適用されている現在のメタ構成が返されます。

Get-DscLocalConfigurationManager

コンピューターから現在の構成を削除する

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

ローカル構成マネージャーで設定を構成する

Set-DSCLocalConfigurationManager コマンドレットを使って、コンピューターにメタ構成 MOF ファイルを適用します。 メタ構成 MOF へのパスが必要です。

Set-DSCLocalConfigurationManager -Path 'c:\metaconfig\localhost.meta.mof' -Verbose

Windows PowerShell Desired State Configuration のログ ファイル

DSC のログは、Windows イベント ログに Microsoft-Windows-Dsc/Operational 書き込まれます。 デバッグ目的で他のログを有効にするには、「 DSC イベント ログの場所」の手順に従います。