WaitForAny-Ressource in DSC

Gilt für: Windows PowerShell 5.1

Die DSC-Ressource (Desired State Configuration) WaitForAny kann innerhalb eines Knotenblocks in einer DSC-Konfiguration verwendet werden, um Abhängigkeiten von Konfigurationen auf anderen Knoten anzugeben.

Hinweis

In dieser Dokumentation dieser DSC-Ressource wird die Version behandelt, die in PowerShell vor Version 7.2 enthalten ist. Das PSDscResources-Modul enthält neue und aktualisierte DSC-Ressourcen, die offiziell von Microsoft unterstützt werden. Das Modul PSDscResources ist im PowerShell-Katalog verfügbar.

Weitere Informationen und aktualisierte Dokumentation finden Sie in der PSDscResources-Referenzdokumentation.

Diese Ressource ist erfolgreich, wenn sich die mit der Eigenschaft ResourceName angegebene Ressource auf einem beliebigen der in der Eigenschaft NodeName definierten Zielknoten im gewünschten Zustand befindet.

Hinweis

Die Ressource WaitForAny verwendet die Windows-Remoteverwaltung, um den Status anderer Knoten zu überprüfen. Weitere Informationen zu Anforderungen zur Portierung und Sicherheit für WinRM finden Sie unter Sicherheitsaspekte von PowerShell-Remoting.

Syntax

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

Eigenschaften

Eigenschaft	Beschreibung
Ressourcenname	Der Ressourcenname für die Abhängigkeit. Wenn diese Ressource zu einer anderen Konfiguration gehört, formatieren Sie den Namen als [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName].
NodeName	Die Zielknoten der Ressource für die Abhängigkeit.
RetryIntervalSec	Die Anzahl von Sekunden bis zu einem Neuversuch. Der Mindestwert lautet 1.
RetryCount	Die maximal zulässige Anzahl von Neuversuchen.
ThrottleLimit	Die Anzahl von Computern, die gleichzeitig eine Verbindung herstellen können. Die Standardeinstellung lautet New-CimSession.

Allgemeine Eigenschaften

Eigenschaft	BESCHREIBUNG
DependsOn	Gibt an, dass die Konfiguration einer anderen Ressource ausgeführt werden muss, bevor diese Ressource konfiguriert wird. Wenn beispielsweise die ID des Skriptblocks mit der Ressourcenkonfiguration, den Sie zuerst ausführen möchten, „ResourceName“ und dessen Typ „ResourceType“ ist, lautet die Syntax für das Verwenden dieser Eigenschaft DependsOn = "[ResourceType]ResourceName".
PsDscRunAsCredential	Legt die Anmeldeinformationen für die Ausführung der gesamten Ressource fest.

Hinweis

Die allgemeine Eigenschaft PsDscRunAsCredential wurde in WMF 5.0 hinzugefügt, um das Ausführen einer beliebigen DSC-Ressource in Verbindung mit anderen Anmeldeinformationen zu ermöglichen. Weitere Informationen finden Sie unter Use Credentials with DSC Resources (Verwenden von Anmeldeinformationen mit DSC-Ressourcen).

Beispiel

Ein Beispiel zur Verwendung dieser Ressource finden Sie unter Angeben knotenübergreifender Abhängigkeiten.