Test-ComputerSecureChannel

Artigo
10/30/2009

Testa e repara o canal seguro entre o computador local e seu domínio.

Sintaxe

Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Test-ComputerSecureChannel verifica que o canal seguro entre o computador local e seu domínio está funcionando corretamente verificando o status da sua relação de confiança. Se uma conexão falhar, você pode usar o parâmetro Repair para tentar restaurá-la.

Test-ComputerSecureChannel retorna "True" se o canal seguro estiver funcionando corretamente e "False" se não estiver. Esse resultado permite usar o cmdlet em instruções condicionais em funções e scripts. Para obter resultados mais detalhados do teste, use o parâmetro Verbose.

O funcionamento desse cmdlet é parecido com o de NetDom.exe. NetDom e Test-ComputerSecureChannel usam o serviço NetLogon para realizar as ações.

Parâmetros

-Repair

Remove e reconstrói o canal seguro estabelecido pelo serviço NetLogon. Use esse parâmetro para tentar restaurar a conexão com falha no teste (retornou "False").

Para usar este parâmetro, o usuário atual deve ser membro do grupo Administradores no computador local.

Necessário?	false
Posição?	named
Valor padrão	Nenhum
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Server <string>

Usa o controlador de domínio especificado para executar o comando. Se esse parâmetro for omitido, Test-ComputerSecureChannel selecionará um controlador de domínio padrão para a operação.

Necessário?	false
Posição?	named
Valor padrão	Nenhum
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

System.Boolean

O cmdlet retorna “True” quando a conexão está funcionando corretamente e “False” quando não está.

Observações

Para executar o comando Test-ComputerSecureChannel no Windows Vista e em versões mais recentes do Windows, abra o Windows PowerShell com a opção "Executar como administrador".

Test-ComputerSecureChannel é implementado usando a função I_NetLogonControl2, que controla vários aspectos do serviço Netlogon.

Exemplo 1

C:\PS>test-computersecurechannel

True

Descrição
-----------
Esse comando testa o canal seguro entre o computador local e o domínio no qual ele ingressou.

Exemplo 2

C:\PS>test-computersecurechannel -server DCName.fabrikam.com

True

Descrição
-----------
Esse comando especifica um controlador de domínio preferencial para o teste.

Exemplo 3

C:\PS>Test-ComputerSecureChannel -repair

True

Descrição
-----------
Esse comando define o canal seguro entre o computador local e seu domínio.

Exemplo 4

C:\PS>test-computerSecureChannel -verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

Descrição
-----------
Esse comando usa o parâmetro comum Verbose para solicitar mensagens detalhadas sobre a operação. Para obter mais informações sobre parâmetro Verbose, consulte about_CommonParameters.

Exemplo 5

C:\PS>set-alias tcsc test-computersecurechannel 

if (!(tcsc)) 
     {write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }

Descrição
-----------
Este exemplo mostra como usar Test-ComputerSecureChannel para testar uma conexão antes de executar um script que requer a conexão.

O primeiro comando usa o cmdlet Set-Alias para criar um alias para o nome do cmdlet. Isso economiza espaço e impede erros de digitação.

A instrução If verifica o valor retornado por Test-ComputerSecureChannel antes de executar um script.

Consulte também

Conceitos

Checkpoint-Computer
Restart-Computer
Stop-Computer
Reset-ComputerMachinePassword

Compartilhar via