Compartilhar via

Test-ComputerSecureChannel

  • Referência
Módulo:
Microsoft.PowerShell.Management

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

Sintaxe

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Test-ComputerSecureChannel verifica se o canal entre o computador local e seu domínio está funcionando corretamente verificando o status de suas relações de confiança. Se uma conexão falhar, você poderá usar o parâmetro Reparar para tentar restaurá-la.

Test-ComputerSecureChannel retornará $True se o canal estiver funcionando corretamente e $False se não estiver. Esse resultado permite que você use o cmdlet em instruções condicionais em funções e scripts. Para obter resultados de teste mais detalhados, use o parâmetro Verbose.

Este cmdlet funciona muito parecido com NetDom.exe. O NetDom e o Test-ComputerSecureChannel usar o serviço NetLogon para executar as ações.

Exemplos

Exemplo 1: testar um canal entre o computador local e seu domínio

PS C:\> Test-ComputerSecureChannel
True

Esse comando testa o canal entre o computador local e o domínio ao qual ele está ingressado.

Exemplo 2: testar um canal entre o computador local e um controlador de domínio

PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Esse comando especifica um controlador de domínio preferencial para o teste.

Exemplo 3: Redefinir o canal entre o computador local e seu domínio

PS C:\> Test-ComputerSecureChannel -Repair
True

Esse comando redefine o canal entre o computador local e seu domínio.

Exemplo 4: Exibir informações detalhadas sobre o teste

PS C:\> 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."

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

Exemplo 5: testar uma conexão antes de executar um script

PS C:\> Set-Alias tcsc Test-ComputerSecureChannel
if (!(tcsc))
{Write-Host "Connection failed. Reconnect and retry."}
else { &(.\Get-Servers.ps1) }

Este exemplo mostra como usar Test-ComputerSecureChannel para testar uma conexão antes de executar um script que exija 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 que Test-ComputerSecureChannel retorna antes de executar um script.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica uma conta de usuário que tem permissão para executar essa ação. Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential, como um que o cmdlet Get-Credential retorna. Por padrão, o cmdlet usa as credenciais do usuário atual.

O parâmetro de Credenciais foi projetado para uso em comandos que usam o parâmetro Reparar para reparar o canal entre o computador e o domínio.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Repair

Indica que esse cmdlet remove e recompila o canal estabelecido pelo serviço NetLogon. Use esse parâmetro para tentar restaurar uma conexão que falhou no teste.

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Server

Especifica o controlador de domínio para executar o comando. Se esse parâmetro não for especificado, esse cmdlet selecionará um controlador de domínio padrão para a operação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Não é possível redirecionar a entrada para este cmdlet.

Saídas

Boolean

Esse cmdlet retornará $True se a conexão estiver funcionando corretamente e $False se não estiver.

Observações

  • Para executar um comando Test-ComputerSecureChannel no Windows Vista e versões posteriores do sistema operacional Windows, abra o Windows PowerShell usando a opção Executar como administrador.
  • Test-ComputerSecureChannel é implementado usando a função I_NetLogonControl2, que controla vários aspectos do serviço Netlogon.