次の方法で共有


ノードの相互依存関係の指定

適用先:Windows PowerShell 5.0

DSC には、WaitForAllWaitForAnyWaitForSome などの特別なリソースが用意されています。このリソースを構成で使用すると、他のノードの構成への依存関係を指定することができます。 これらのリソースの動作は次のとおりです。

  • WaitForAll: NodeName プロパティで定義されているすべてのターゲット ノードで、指定されたリソースが目的の状態である場合に成功します。
  • WaitForAny: NodeName プロパティで定義されているターゲット ノードの少なくとも 1 つで、指定されたリソースが目的の状態である場合に成功します。
  • WaitForSome: NodeName プロパティのほか、NodeCount プロパティも指定します。 リソースは、NodeName プロパティで定義されたノードの最小数 (NodeCount で指定) で目的の状態になった場合に成功します。

構文

WaitForAll リソースと WaitForAny リソースは構文が同じです。 次の例の <ResourceType> を、WaitForAny または WaitForAll に置き換えます。 DependsOn キーワードと同じように、名前は [ResourceType]ResourceName という形式にする必要があります。 リソースが異なる Configuration に属している場合は、ConfigurationName を書式設定する文字列 [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName] に含めます。 NodeName は、現在のリソースが待機する必要があるコンピューターまたはノードです。

<ResourceType> [string] #ResourceName
{
    ResourceName = [string]
    NodeName = [string]
    [ DependsOn = [string[]] ]
    [ PsDscRunAsCredential = [PSCredential]]
    [ RetryCount = [Uint32] ]
    [ RetryIntervalSec = [Uint64] ]
    [ ThrottleLimit = [Uint32]]
}

WaitForSome リソースは上の例と似た構文ですが、NodeCount キーを追加します。 NodeCount は、現在のリソースが待機する必要のあるノードの数を示します。

WaitForSome [String] #ResourceName
{
    NodeCount = [UInt32]
    NodeName = [string[]]
    ResourceName = [string]
    [DependsOn = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
    [RetryCount = [UInt32]]
    [RetryIntervalSec = [UInt64]]
    [ThrottleLimit = [UInt32]]
}

すべての WaitForXXXX が次の構文キーを共有します。

プロパティ 説明
RetryIntervalSec 再試行するまでの秒数。 最小値は 1 です。
RetryCount 再試行の回数の最大数。
ThrottleLimit 同時に接続するコンピューターの数。 既定値は、New-CimSession の既定値です。
DependsOn このリソースを構成する前に、他のリソースの構成を実行する必要があることを示します。 詳細については、DependsOn に関するページを参照してください。
PsDscRunAsCredential ユーザーの資格情報を指定した DSC の使用に関するページを参照してください。

WaitForXXXX リソースの使用

WaitForXXXX リソースは、指定されたノードで指定された数のリソースが完了するのを待機します。 同じ Configuration の他のリソースは、DependsOn キーを使用して WaitForXXXX リソースに "依存する" ことができます。

たとえば、次の構成では、ターゲット ノードは MyDC ノード上の xADDomain リソースが完了するまで 15 秒間隔で最大 30 回試行しながら待機した後、ドメインに参加できるようになります。

既定では、WaitForXXX リソースは 1 回試行してから失敗します。 これは必須ではありませんが、通常は、RetryCountRetryIntervalSec を指定します。

Configuration JoinDomain
{
    Import-DSCResource -ModuleName xComputerManagement, xActiveDirectory

    Node myDC
    {
        WindowsFeature InstallAD
        {
            Ensure = 'Present'
            Name = 'AD-Domain-Services'
        }

        xADDomain NewDomain
        {
            DomainName = 'Contoso.com'
            DomainAdministratorCredential = (Get-Credential)
            SafemodeAdministratorPassword = (Get-Credential)
            DatabasePath = "C:\Windows\NTDS"
            LogPath = "C:\Windows\NTDS"
            SysvolPath = "C:\Windows\Sysvol"
        }
    }

    Node myDomainJoinedServer
    {
        WaitForAll DC
        {
            ResourceName      = '[xADDomain]NewDomain'
            NodeName          = 'MyDC'
            RetryIntervalSec  = 15
            RetryCount        = 30
        }

        xComputer JoinDomain
        {
            Name             = 'myPC'
            DomainName       = 'Contoso.com'
            Credential       = (Get-Credential)
            DependsOn        ='[WaitForAll]DC'
        }
    }
}

Configuration をコンパイルすると、2 つの ".mof" ファイルが生成されます。 Start-DSCConfiguration コマンドレットを使って、両方の ".mof" ファイルをターゲットの Node に適用します

Note

WaitForXXX リソースでは、Windows リモート管理を使用して他のノードの状態を確認します。 WinRM でのポートとセキュリティ要件の詳細については、「PowerShell リモート処理のセキュリティに関する考慮事項」を参照してください。

参照