Condividi tramite

Test-ComputerSecureChannel

Modulo:
Microsoft.PowerShell.Management Module

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 Test-ComputerSecureChannel cmdlet 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.exea . Sia NetDom che Test-ComputerSecureChannel usano il servizio NetLogon per eseguire le azioni.

Annotazioni

Questo cmdlet funziona solo nei computer membri del dominio. Quando viene eseguito nei controller di dominio, restituisce errori falsi positivi. Per verificare e reimpostare i canali sicuri per i controller di dominio, usare netdom.exe o nltest.exe.

Esempio

Esempio 1: Testare un canale tra il computer locale e il relativo dominio

Test-ComputerSecureChannel

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

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

Test-ComputerSecureChannel -Repair

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

Esempio 4: Visualizzazione di informazioni dettagliate sul test

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 altre informazioni su Verbose, vedere about_CommonParameters.

Esempio 5: Testare una connessione prima di eseguire uno script

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

Questo esempio illustra come usare Test-ComputerSecureChannel per testare una connessione prima di eseguire uno script che richiede la connessione.

L'istruzione if controlla il valore restituito prima di Test-ComputerSecureChannel 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 in caso contrario.

Note

  • Per eseguire un comando Test-ComputerSecureChannel in Windows Vista e versioni successive del sistema operativo Windows, aprire Windows PowerShell usando l'opzione Esegui come amministratore.
  • Test-ComputerSecureChannel viene implementato tramite la funzione I_NetLogonControl2 , che controlla vari aspetti del servizio Netlogon.