Partilhar via

Test-DscConfiguration

Módulo:
PSDesiredStateConfiguration Module v1.1

Testa se a configuração real nos nós corresponde à configuração desejada.

Sintaxe

ComputerNameSet (Predefinição) 

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

ComputerNameAndPathSet 

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Path] <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

ComputerNameAndReferenceConfigurationSet 

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    -ReferenceConfiguration <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndPathSet 

Test-DscConfiguration
    [-Path] <String>
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndReferenceConfigurationSet 

Test-DscConfiguration
    -CimSession <CimSession[]>
    -ReferenceConfiguration <String>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionSet 

Test-DscConfiguration
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Description

O cmdlet Test-DscConfiguration testa se a configuração real nos nós corresponde à configuração desejada. Especifique quais computadores você deseja testar configurações usando nomes de computador ou sessões de Modelo Comum de Informações (CIM). Se você não especificar um computador de destino, o cmdlet testará a configuração do computador local.

Se as configurações desejadas e reais corresponderem, o cmdlet retornará um valor de cadeia de caracteres 'True'. Caso contrário, ele retorna um valor de cadeia de caracteres de 'False'.

Exemplos

Exemplo 1: Testar a configuração para o computador local

Test-DscConfiguration

Este comando testa a configuração do computador local.

Exemplo 2: Configuração de teste para um computador especificado

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

Este exemplo testa a configuração de um computador especificado por uma sessão CIM. O exemplo cria uma sessão CIM para um computador chamado Server01 para uso com o cmdlet. Como alternativa, crie uma matriz de sessões CIM para aplicar o cmdlet a vários computadores especificados.

O primeiro comando cria uma sessão CIM usando o cmdlet New-CimSession e, em seguida, armazena o objeto CimSession na variável $Session. O comando solicita uma senha. Para obter mais informações, digite Get-Help New-CimSession.

O segundo comando testa a configuração para os computadores identificados pelo CimSession objetos armazenados na variável $Session, neste caso, o computador chamado Server01.

Exemplo 3: Configurações de teste com resultados detalhados

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Este comando testa configurações para um conjunto de computadores especificados pelo parâmetro ComputerName e retorna informações detalhadas que incluem o estado geral, recursos que estão no estado desejado, recursos que não estão no estado desejado e nome do computador.

Exemplo 4: Configurações de teste especificadas em uma pasta

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Este comando testa as configurações definidas em uma pasta especificada pelo parâmetro Path. As configurações são testadas em relação a um conjunto de computadores, cada um identificado pelo nome do arquivo de configuração.

Exemplo 5: Configurações de teste especificadas em um arquivo

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Este comando testa uma configuração definida em um arquivo em relação a um conjunto de computadores especificados pelo parâmetro ComputerName.

Parâmetros

-AsJob

Indica que esse cmdlet executa o comando como um trabalho em segundo plano.

Se você especificar o parâmetro AsJob, o comando retornará um objeto que representa o trabalho e exibirá o prompt de comando. Você pode continuar a trabalhar na sessão até que o trabalho termine. O trabalho é criado no computador local e os resultados de computadores remotos são retornados automaticamente para o computador local. Para gerenciar o trabalho, use os cmdlets Job. Para obter os resultados do trabalho, use o cmdlet Receive-Job.

Para usar esse parâmetro, os computadores locais e remotos devem ser configurados para comunicação remota e, no Windows Vista e em versões posteriores do sistema operacional Windows, você deve abrir o Windows PowerShell com a opção Executar como administrador. Para obter mais informações, consulte about_Remote_Requirements.

Para obter mais informações sobre trabalhos em segundo plano do Windows PowerShell, consulte about_Jobs e about_Remote_Jobs.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CimSession

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um New-CimSession ou cmdlet Get-CimSession. O padrão é a sessão atual no computador local.

Propriedades dos parâmetros

Tipo:

CimSession[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CimSessionAndPathSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndReferenceConfigurationSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ComputerName

Especifica uma matriz de nomes de computador na qual esse cmdlet testa a configuração. O cmdlet testa o documento de configuração no local especificado pelo parâmetro Path para esses computadores.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:China, Nome do servidor

Conjuntos de parâmetros

ComputerNameSet
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndPathSet
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndReferenceConfigurationSet
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Credential

Especifica um nome de usuário e senha, como um objeto de PSCredential , para o computador de destino. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndPathSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndReferenceConfigurationSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Detailed

Indica que esse cmdlet retorna um resultado detalhado da comparação do documento de configuração com o estado desejado dos nós. O resultado inclui informações como o estado geral, recursos que estão no estado desejado, recursos que não estão no estado desejado e nome do computador.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Path

Especifica o caminho de uma pasta que contém arquivos de documento de configuração. O cmdlet testa a configuração em relação ao estado desejado dos computadores especificados pelo ComputerName ou parâmetro CimSession.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameAndPathSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndPathSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ReferenceConfiguration

Especifica o caminho do arquivo de documento de configuração. Este cmdlet testa a configuração em relação ao estado real dos computadores especificados pelo ComputerName ou parâmetro CimSession.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameAndReferenceConfigurationSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndReferenceConfigurationSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se esse parâmetro for omitido ou um valor de 0 for inserido, o Windows PowerShell calculará um limite de aceleração ideal para o cmdlet com base no número de cmdlets CIM em execução no computador. O limite de aceleração aplica-se apenas ao cmdlet atual, não à sessão ou ao computador.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.