Recurso de DSC WaitForAny

Aplica-se a: Windows PowerShell 5.1

O recurso de DSC (Desired State Configuration) WaitForAny pode ser usado dentro de um bloco de nó em uma configuração DSC para especificar dependências de configurações em outros nós.

Observação

Esta documentação desse recurso DSC aborda a versão incluída no PowerShell antes da versão 7.2. O módulo PSDscResources contém recursos de DSC novos e atualizados com suporte oficial da Microsoft. O módulo PSDscResources está disponível na Galeria do PowerShell.

Para obter mais informações e documentação atualizada, consulte a documentação de referência PSDscResources.

Esse recurso terá êxito se o recurso especificado pela propriedade ResourceName estiver no estado desejado em qualquer nó de destino definido na propriedade NodeName.

Observação

O recurso WaitForAny usa o Gerenciamento Remoto do Windows para verificar o estado dos outros nós. Para obter mais informações sobre os requisitos de porta e segurança do WinRM, confira Considerações sobre segurança da comunicação remota do PowerShell.

Sintaxe

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

Propriedades

Propriedade	Descrição
ResourceName	O nome do recurso do qual dependerá. Se esse recurso pertencer a uma configuração diferente, formate o nome como [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName].
NodeName	Os nós de destino do recurso do qual dependerá.
RetryIntervalSec	O número de segundos antes de tentar novamente. O mínimo é 1.
RetryCount	O número máximo de tentativas.
ThrottleLimit	O número de máquinas para conectar-se simultaneamente. O padrão é New-CimSession.

Propriedades comuns

Propriedade	Descrição
DependsOn	Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será DependsOn = "[ResourceType]ResourceName".
PsDscRunAsCredential	Define a credencial para executar todo o recurso.

Observação

A propriedade comum PsDscRunAsCredential foi adicionada ao WMF 5.0 para permitir a execução de qualquer recurso de DSC no contexto de outras credenciais. Para saber mais, confira Usar credenciais com recursos de DSC.

Exemplo

Para obter um exemplo de como usar esse recurso, consulte Especificando dependências de nó cruzado