Test-ComputerSecureChannel

Verifica e ripristina il canale sicuro tra il computer locale e il relativo dominio.

Sintassi

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

Descrizione

Il cmdlet Test-ComputerSecureChannel verifica che il canale sicuro tra il computer locale e il relativo dominio funzioni correttamente controllando lo stato delle relazioni di trust. Se una connessione non riesce, è possibile utilizzare il parametro Repair per tentare di ripristinarla.

Test-ComputerSecureChannel restituisce "True" se il canale sicuro funziona correttamente; in caso contrario "False". Questo risultato consente di utilizzare il cmdlet nelle istruzioni condizionali di funzioni e script. Per ottenere risultati di test più dettagliati, utilizzare il parametro Verbose.

Questo cmdlet funziona in modo analogo a NetDom.exe. Sia NetDom che Test-ComputerSecureChannel utilizzano il servizio Accesso rete per eseguire le azioni.

Parametri

-Repair

Rimuove e crea nuovamente il canale sicuro stabilito dal servizio Accesso rete. Utilizzare questo parametro per tentare di ripristinare una connessione che non ha superato il test (ha restituito "False").

Per utilizzare questo parametro, l'utente corrente deve essere membro del gruppo Administrators nel computer locale.

-Server <string>

Utilizza il controller di dominio specificato per eseguire il comando. Se questo parametro viene omesso, Test-ComputerSecureChannel seleziona un controller di dominio predefinito per l'operazione.

-Confirm

Chiede una conferma prima di eseguire il comando.

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Note

Per eseguire un comando Test-ComputerSecureChannel in Windows Vista e nelle versioni successive di Windows, aprire Windows PowerShell con l'opzione "Esegui come amministratore".

Test-ComputerSecureChannel viene implementato tramite la funzione I_NetLogonControl2 che controlla vari aspetti del servizio Accesso rete.

Esempio 1

C:\PS>test-computersecurechannel

True

Descrizione
-----------
Questo comando verifica il canale sicuro tra il computer locale e il dominio a cui è stato aggiunto.

Esempio 2

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

True

Descrizione
-----------
Questo comando specifica un controller di dominio preferito per il test.

Esempio 3

C:\PS>Test-ComputerSecureChannel -repair

True

Descrizione
-----------
Questo comando reimposta il canale sicuro tra il computer locale e il relativo dominio.

Esempio 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."

Descrizione
-----------
Questo comando utilizza il parametro comune Verbose per richiedere messaggi dettagliati sull'operazione. Per ulteriori informazioni sul parametro Verbose, vedere about_CommonParameters.

Esempio 5

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

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

Descrizione
-----------
In questo esempio viene illustrato come utilizzare Test-ComputerSecureChannel per verificare una connessione prima di eseguire uno script che richiede la connessione.

Il primo comando utilizza il cmdlet Set-Alias per creare un alias per il nome del cmdlet. Ciò consente di risparmiare spazio ed evita gli errori di battitura.

L'istruzione If verifica il valore restituito da Test-ComputerSecureChannel prima dell'esecuzione di uno script.

Vedere anche

Concetti

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