複合リソース: DSC 構成をリソースとして使用する

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

実際の状況では、構成が長くて複雑になり、さまざまなリソースを呼び出し、膨大な数のプロパティを設定する可能性があります。 この複雑さに対処するために、Windows PowerShell の Desired State Configuration (DSC) 構成を他の構成のリソースとして使用できます。 これは複合リソースと呼ばれます。 複合リソースは、パラメーターを受け取る DSC 構成です。 構成のパラメーターは、リソースのプロパティとして機能します。 設定は、拡張子が .schema.psm1 のファイルとして保存されます。 これは、MOF スキーマと、一般的な DSC リソースのリソース スクリプトの両方を置き換えます。 DSC リソースの詳細については、「 Windows PowerShell の望ましい状態構成リソース」を参照してください。

複合リソースの作成

この例では、仮想マシンを構成するために多数の既存のリソースを呼び出す構成を作成します。 設定ブロックで設定する値を指定する代わりに、設定は設定ブロックで使用されるパラメータを受け取ります。

Configuration xVirtualMachine
{
    param
    (
        # Name of VMs
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String[]] $VMName,

        # Name of Switch to create
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $SwitchName,

        # Type of Switch to create
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $SwitchType,

        # Source Path for VHD
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $VHDParentPath,

        # Destination path for diff VHD
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $VHDPath,

        # Startup Memory for VM
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $VMStartupMemory,

        # State of the VM
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $VMState
    )

    # Import the module that defines custom resources
    Import-DSCResource -ModuleName xComputerManagement,xHyper-V

    # Install the Hyper-V role
    WindowsFeature HyperV
    {
        Ensure = "Present"
        Name = "Hyper-V"
    }

    # Create the virtual switch
    xVMSwitch $SwitchName
    {
        Ensure = "Present"
        Name = $SwitchName
        Type = $SwitchType
        DependsOn = "[WindowsFeature]HyperV"
    }

    # Check for Parent VHD file
    File ParentVHDFile
    {
        Ensure = "Present"
        DestinationPath = $VHDParentPath
        Type = "File"
        DependsOn = "[WindowsFeature]HyperV"
    }

    # Check the destination VHD folder
    File VHDFolder
    {
        Ensure = "Present"
        DestinationPath = $VHDPath
        Type = "Directory"
        DependsOn = "[File]ParentVHDFile"
    }

    # Create VM specific diff VHD
    foreach ($Name in $VMName)
    {
        xVHD "VHD$Name"
        {
            Ensure = "Present"
            Name = $Name
            Path = $VHDPath
            ParentPath = $VHDParentPath
            DependsOn = @("[WindowsFeature]HyperV",
                          "[File]VHDFolder")
        }
    }

    # Create VM using the above VHD
    foreach($Name in $VMName)
    {
        xVMHyperV "VMachine$Name"
        {
            Ensure = "Present"
            Name = $Name
            VhDPath = (Join-Path -Path $VHDPath -ChildPath $Name)
            SwitchName = $SwitchName
            StartupMemory = $VMStartupMemory
            State = $VMState
            MACAddress = $MACAddress
            WaitForIP = $true
            DependsOn = @("[WindowsFeature]HyperV",
                          "[xVHD]VHD$Name")
        }
    }
}

構成を複合リソースとして保存する

パラメーター化された構成を DSC リソースとして使用するには、他の MOF ベースのリソースと同じディレクトリ構造に保存し、 .schema.psm1 拡張子を付けて名前を付けます。 この例では、ファイルの名前を xVirtualMachine.schema.psm1にします。 また、次の行を含む xVirtualMachine.psd1 という名前のマニフェストを作成する必要があります。

RootModule = 'xVirtualMachine.schema.psm1'

完了すると、フォルダー構造は次のようになります。

$env: psmodulepath
    |- MyDscResources
        |- MyDscResources.psd1
        |- DSCResources
            |- xVirtualMachine
                |- xVirtualMachine.psd1
                |- xVirtualMachine.schema.psm1

これで、リソースは Get-DscResource コマンドレットを使用して検出でき、そのプロパティは、そのコマンドレットまたは Windows PowerShell ISE の Ctrl+Space オートコンプリートを使用して検出できます。

複合リソースの使用

次に、複合リソースを呼び出す構成を作成します。 この構成では、xVirtualMachine コンポジット リソースを呼び出して仮想マシンを作成し、 xComputer リソースを呼び出して名前を変更します。

configuration RenameVM
{
    Import-DSCResource -ModuleName xVirtualMachine
    Node localhost
    {
        xVirtualMachine VM
        {
            VMName = "Test"
            SwitchName = "Internal"
            SwitchType = "Internal"
            VhdParentPath = "C:\Demo\VHD\RTM.vhd"
            VHDPath = "C:\Demo\VHD"
            VMStartupMemory = 1024MB
            VMState = "Running"
        }
    }

    Node "192.168.10.1"
    {
        xComputer Name
        {
            Name = "SQL01"
            DomainName = "fourthcoffee.com"
        }
    }
}

このリソースを使用して、VM 名の配列を xVirtualMachine リソースに渡すことで、複数の VM を作成することもできます。

Configuration MultipleVms
{
    Import-DSCResource -ModuleName xVirtualMachine
    Node localhost
    {
        xVirtualMachine VMs
        {
            VMName = "IIS01", "SQL01", "SQL02"
            SwitchName = "Internal"
            SwitchType = "Internal"
            VhdParentPath = "C:\Demo\VHD\RTM.vhd"
            VHDPath = "C:\Demo\VHD"
            VMStartupMemory = 1024MB
            VMState = "Running"
        }
    }
}

PsDscRunAsCredential のサポート

PsDscRunAsCredential プロパティを DSC 構成リソース ブロックで使用して、指定された資格情報セットでリソースを実行するように指定できます。 詳細については、「 ユーザー資格情報を使用した DSC の実行」を参照してください。

カスタムリソース内からユーザーコンテキストにアクセスするには、自動変数 $PsDscContextを使用できます。

たとえば、次のコードでは、リソースが実行されているユーザー コンテキストを詳細な出力ストリームに書き込みます。

if ($PsDscContext.RunAsUser) {
    Write-Verbose "User: $PsDscContext.RunAsUser";
}

こちらもご覧ください

概念

• MOF を使用したカスタム DSC リソースの記述
• Windows PowerShell の望ましい状態構成の概要