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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<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.
|
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
System.Boolean Il cmdlet restituisce "True" quando la connessione funziona correttamente e "False" in caso contrario. |
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