Test-ComputerSecureChannel
Verifica e ripristina il canale sicuro tra il computer locale e il relativo dominio.
Sintassi
Default (Impostazione predefinita)
Test-ComputerSecureChannel
[-Repair]
[-Server <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Test-ComputerSecureChannel verifica che il canale 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 provare a ripristinarla.
Test-ComputerSecureChannel restituisce $True se il canale funziona correttamente e $False in caso contrario. Questo risultato consente di utilizzare il cmdlet nelle istruzioni condizionali nelle funzioni e negli script. Per ottenere risultati di test più dettagliati, utilizzare il parametro Dettagliato .
Questo cmdlet funziona in modo molto simile NetDom.exe. Sia NetDom che Test-ComputerSecureChannel utilizzano il servizio NetLogon per eseguire le azioni.
Esempio
Esempio 1: Testare un canale tra il computer locale e il relativo dominio
PS C:\> Test-ComputerSecureChannel
True
Questo comando verifica il canale tra il computer locale e il dominio a cui è aggiunto.
Esempio 2: Testare un canale tra il computer locale e un controller di dominio
PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True
Questo comando specifica un controller di dominio preferito per il test.
Esempio 3: Reimpostare il canale tra il computer locale e il relativo dominio
PS C:\> Test-ComputerSecureChannel -Repair
True
Questo comando reimposta il canale tra il computer locale e il relativo dominio.
Esempio 4: Visualizzazione di informazioni dettagliate sul test
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."
Questo comando utilizza il parametro comune dettagliato per richiedere messaggi dettagliati sull'operazione. Per ulteriori informazioni su Verbose, vedere about_CommonParameters.
Esempio 5: Testare una connessione prima di eseguire uno script
PS C:\> Set-Alias tcsc Test-ComputerSecureChannel
if (!(tcsc))
{Write-Host "Connection failed. Reconnect and retry."}
else { &(.\Get-Servers.ps1) }
In questo esempio viene illustrato come utilizzare Test-ComputerSecureChannel per testare 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. In questo modo si risparmia spazio e si evitano errori di digitazione.
L'istruzione If controlla il valore restituito da Test-ComputerSecureChannel prima di eseguire uno script.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Credential
Specifica un account utente autorizzato a eseguire questa azione. Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential , ad esempio uno restituito dal cmdlet Get-Credential. Per impostazione predefinita, il cmdlet usa le credenziali dell'utente corrente.
Il parametro Credential è progettato per l'utilizzo nei comandi che utilizzano il parametro Repair per ripristinare il canale tra il computer e il dominio.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Repair
Indica che questo cmdlet rimuove e quindi ricompila il canale stabilito dal servizio Accesso rete. Utilizzare questo parametro per provare a ripristinare una connessione che non ha superato il test.
Per utilizzare questo parametro, l'utente corrente deve essere membro del gruppo Administrators nel computer locale.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Server
Specifica il controller di dominio per l'esecuzione del comando. Se questo parametro non viene specificato, questo cmdlet seleziona un controller di dominio predefinito per l'operazione.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Non è possibile inviare tramite pipe l'input a questo cmdlet.
Output
Boolean
Questo cmdlet restituisce $True se la connessione funziona correttamente e $False se non lo è.
Note
- Per eseguire un comando Test-ComputerSecureChannel in Windows Vista e versioni successive del sistema operativo Windows, aprire Windows PowerShell utilizzando l'opzione Esegui come amministratore.
- Test-ComputerSecureChannel viene implementato utilizzando la funzione I_NetLogonControl2 , che controlla vari aspetti del servizio Accesso rete.