Test-ComputerSecureChannel

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

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

Sintassi

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 usare il parametro Repair per provare a ripristinarlo.

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

Questo cmdlet funziona in modo molto simile NetDom.exea . Sia NetDom che Test-ComputerSecureChannel usano il servizio NetLogon per eseguire le azioni.

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 viene 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: Visualizzare 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 usa il parametro comune Verbose 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un account utente che dispone delle autorizzazioni per eseguire questa azione. Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential. Per impostazione predefinita, il cmdlet usa le credenziali dell'utente corrente.

Il parametro Credential è progettato per l'uso nei comandi che usano il parametro Repair per ripristinare il canale tra il computer e il dominio.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repair

Indica che questo cmdlet rimuove e quindi ricompila il canale stabilito dal servizio NetLogon. Usare questo parametro per tentare di ripristinare una connessione che non ha superato il test.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Server

Specifica il controller di dominio per eseguire il comando. Se questo parametro non viene specificato, questo cmdlet seleziona un controller di dominio predefinito per l'operazione.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Non è possibile inviare input tramite pipe a questo cmdlet.

Output

Boolean

Questo cmdlet restituisce $True se la connessione funziona correttamente e $False in caso contrario.

Note

  • Per eseguire un Test-ComputerSecureChannel comando 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.