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 |
None 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.
See Also