Partilhar via

Test-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

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

Syntax

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

Description

O Test-DscConfiguration cmdlet testa se a configuração real nos nós corresponde à configuração pretendida. Especifique os computadores para os quais pretende testar as configurações com nomes de computador ou sessões do Common Information Model (CIM). Se não especificar um computador de destino, o cmdlet testa a configuração do computador local.

Se as configurações pretendidas e reais corresponderem, o cmdlet devolve um valor de cadeia de carateres de "Verdadeiro". Caso contrário, devolve um valor de cadeia de carateres de "Falso".

Exemplos

Exemplo 1: testar a configuração do computador local

Test-DscConfiguration

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

Exemplo 2: Testar a configuração de um computador especificado

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

Este exemplo de configuração de teste a partir de um computador especificado por uma sessão CIM. O exemplo cria uma sessão CIM para um computador com o nome Server01 para utilização com o cmdlet . Em 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 com o New-CimSession cmdlet e, em seguida, armazena o objeto CimSession na $Session variável . O comando pede-lhe uma palavra-passe. Para mais informações, insira Get-Help New-CimSession.

O segundo comando testa a configuração dos computadores identificados pelos objetos CimSession armazenados na $Session variável, neste caso, o computador com o nome Server01.

Exemplo 3: Testar configurações com resultados detalhados

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

Este comando testa as configurações de um conjunto de computadores especificado pelo parâmetro ComputerName e devolve informações detalhadas que incluem o estado geral, os recursos que estão no estado pretendido, os recursos que não estão no estado pretendido e o nome do computador.

Exemplo 4: Configurações de teste especificadas numa pasta

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

Este comando testa as configurações definidas numa pasta especificada pelo parâmetro Path . As configurações são testadas num conjunto de computadores, cada um identificado pelo nome de ficheiro do ficheiro de configuração.

Exemplo 5: Configurações de teste especificadas num ficheiro

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

Este comando testa uma configuração definida num ficheiro num conjunto de computadores especificado pelo parâmetro ComputerName .

Parâmetros

-AsJob

Indica que este cmdlet executa o comando como uma tarefa em segundo plano.

Se especificar o parâmetro AsJob , o comando devolve um objeto que representa a tarefa e, em seguida, apresenta a linha de comandos. Pode continuar a trabalhar na sessão até que a tarefa termine. A tarefa é criada no computador local e os resultados dos computadores remotos são automaticamente devolvidos ao computador local. Para gerir a tarefa, utilize os Cmdlets da tarefa. Para obter os resultados da tarefa, utilize o Receive-Job cmdlet .

Para utilizar este parâmetro, os computadores locais e remotos têm de ser configurados para comunicação remota e, no Windows Vista e versões posteriores do sistema operativo Windows, tem de abrir Windows PowerShell com a opção Executar como administrador. Para obter mais informações, veja about_Remote_Requirements.

Para obter mais informações sobre Windows PowerShell tarefas em segundo plano, veja about_Jobs e about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . A predefinição é a sessão atual no computador local.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica uma matriz de nomes de computadores nos quais este cmdlet testa a configuração. O cmdlet testa o documento de configuração na localização especificada pelo parâmetro Caminho para estes computadores.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica um nome de utilizador e palavra-passe, como um objeto PSCredential , para o computador de destino. Para obter um objeto PSCredential , utilize o Get-Credential cmdlet . Para mais informações, insira Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica o caminho de uma pasta que contém ficheiros de documentos de configuração. O cmdlet testa a configuração em relação ao estado pretendido dos computadores especificado pelo parâmetro ComputerName ou CimSession .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

Especifica o caminho do ficheiro de documento de configuração. Este cmdlet testa a configuração relativamente ao estado real dos computadores especificado pelo parâmetro ComputerName ou CimSession .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False