Test-ComputerSecureChannel
Testa e repara o canal seguro entre o computador local e o seu domínio.
Syntax
Test-ComputerSecureChannel
[-Repair]
[-Server <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Test-ComputerSecureChannel
cmdlet 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ê pode usar o parâmetro Repair para tentar restaurá-la.
Test-ComputerSecureChannel
retorna $True se o canal está 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 de forma muito semelhante ao NetDom.exe
. NetDom e 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
Test-ComputerSecureChannel
Este comando testa o canal entre o computador local e o domínio ao qual ele está associado.
Exemplo 2: Testar um canal entre o computador local e um controlador de domínio
Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True
Este comando especifica um controlador de domínio preferencial para o teste.
Exemplo 3: Redefinir o canal entre o computador local e seu domínio
Test-ComputerSecureChannel -Repair
Este comando redefine o canal entre o computador local e seu domínio.
Exemplo 4: Exibir informações detalhadas sobre o teste
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."
Este comando usa o parâmetro Verbose common para solicitar mensagens detalhadas sobre a operação. Para obter mais informações sobre Verbose, consulte about_CommonParameters.
Exemplo 5: Testar uma conexão antes de executar um script
if (!(Test-ComputerSecureChannel)) {
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 requer a conexão.
A if
instrução verifica o valor que Test-ComputerSecureChannel
retorna antes de executar um script.
Parâmetros
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Credential foi projetado para uso em comandos que usam o parâmetro Repair para reparar o canal entre o computador e o domínio.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repair
Indica que esse cmdlet remove e recria o canal estabelecido pelo serviço NetLogon. Use este 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Não é possível canalizar a entrada para este cmdlet.
Saídas
Esse cmdlet retorna $True
se a conexão estiver funcionando corretamente e $False
se não estiver.
Notas
- Para executar um
Test-ComputerSecureChannel
comando no Windows Vista e em 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 aspetos do serviço Netlogon.
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários