Ressource DSC WaitForAll

S’applique à : Windows PowerShell 5.x

La ressource de configuration d’état souhaité (DSC) WaitForAll peut être utilisée dans un bloc de nœud dans une configuration DSC pour spécifier les dépendances sur les configurations sur d’autres nœuds.

Notes

Cette documentation de cette ressource DSC couvre la version incluse avec PowerShell antérieure à la version 7.2. Le module PSDscResources contient des ressources DSC nouvelles et mises à jour qui sont officiellement prises en charge par Microsoft. Le module PSDscResources est disponible à partir de PowerShell Gallery.

Pour plus d’informations et la documentation mise à jour, consultez la documentation de référence PSDscResources.

La ressource réussit si la ressource spécifiée par la propriété ResourceName est dans l’état souhaité sur tous les nœuds cibles définis dans la propriété NodeName.

Notes

La ressource WaitForAll utilise Windows Remote Management pour vérifier l’état d’autres nœuds. Pour plus d’informations sur la configuration requise des ports et de la sécurité pour WinRM, consultez Éléments à prendre en compte en matière de sécurité de la communication à distance PowerShell.

Syntaxe

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

Propriétés

Propriété Description
Nom_ressource Le nom de la ressource de la dépendance. Si cette ressource appartient à une configuration différente, mettez le nom sous la forme [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName].
NodeName Les nœuds cible de la ressource de la dépendance.
RetryIntervalSec Le nombre de secondes avant la nouvelle tentative. Le minimum est 1.
RetryCount Le nombre maximum de nouvelles tentatives.
ThrottleLimit Le nombre de machines à connecter simultanément. La valeur par défaut est New-CimSession par défaut.

Propriétés communes

Propriété Description
DependsOn Indique que la configuration d’une autre ressource doit être exécutée avant celle de cette ressource. Par exemple, si vous voulez exécuter en premier le bloc de script de configuration de ressource ayant l’ID ResourceName et le type ResourceType, utilisez la syntaxe suivante pour cette propriété : DependsOn = "[ResourceType]ResourceName".
PsDscRunAsCredential Définit les informations d’identification pour l’exécution de l’ensemble de la ressource.

Notes

La propriété commune PsDscRunAsCredential a été ajoutée à WMF 5.0 pour permettre l’exécution d’une ressource DSC dans le contexte d’autres informations d’identification. Pour plus d’informations, consultez Utiliser des informations d’identification avec des ressources DSC.

Exemple

Pour obtenir un exemple d’utilisation de cette ressource, consultez Spécification des dépendances entre nœuds