Recurso de DSC WaitForAll

  • Artigo

Aplica-se a: Windows PowerShell 5.x

O recurso de DSC (Desired State Configuration) WaitForAll pode ser usado dentro de um bloco de nó em uma configuração DSC para especificar dependências em 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 todos os nós de destino definidos na propriedade NodeName.

Observação

O recurso WaitForAll 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

WaitForAll [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