Testet und repariert den sicheren Kanal zwischen dem lokalen Computer und seiner Domäne.

Syntax

Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Beschreibung

Das Cmdlet "Test-ComputerSecureChannel" überprüft, ob der sichere Kanal zwischen dem lokalen Computer und der entsprechenden Domäne ordnungsgemäß funktioniert, indem der Status der Vertrauensstellungen überprüft wird. Wenn bei einer Verbindung ein Fehler auftritt, können Sie versuchen, sie mit dem Repair-Parameter wiederherzustellen.

Test-ComputerSecureChannel gibt "True" zurück, wenn der sichere Kanal ordnungsgemäß funktioniert, andernfalls "False" . Durch dieses Ergebnis können Sie das Cmdlet in bedingten Anweisungen in Funktionen und Skripts verwenden. Wenn Sie ausführlichere Testergebnisse benötigen, verwenden Sie den Verbose-Parameter.

Die Funktion dieses Cmdlets ist vergleichbar mit "NetDom.exe". Sowohl "NetDom" als auch Test-ComputerSecureChannel führen die Aktionen mithilfe des Diensts "NetLogon" aus.

Parameter

-Repair

Entfernt den vom Dienst "NetLogon" eingerichteten sicheren Kanal und erstellt ihn neu. Verwenden Sie diesen Parameter, um zu versuchen, eine Verbindung wiederherzustellen, bei der der Test nicht erfolgreich war (Rückgabe "False").

Um diesen Parameter zu verwenden, muss der aktuelle Benutzer Mitglied der Gruppe "Administratoren" auf dem lokalen Computer sein.

Erforderlich?

false

Position?

named

Standardwert

keine

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Server <string>

Verwendet den angegebenen Domänencontroller zum Ausführen des Befehls. Wenn dieser Parameter weggelassen wird, wählt Test-ComputerSecureChannel einen Standarddomänencontroller für den Vorgang aus.

Erforderlich?

false

Position?

named

Standardwert

keine

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Bestätigung

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

None

Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.

Ausgaben

System.Boolean

Das Cmdlet gibt "True" zurück, wenn die Verbindung ordnungsgemäß funktioniert, andernfalls "False".

Hinweise

Wenn Sie den Befehl "Test-ComputerSecureChannel" unter Windows Vista und höheren Versionen von Windows ausführen möchten, öffnen Sie Windows PowerShell mit der Option "Als Administrator ausführen".

Test-ComputerSecureChannel wird mit der I_NetLogonControl2-Funktion implementiert, die verschiedene Aspekte des Diensts "Netlogon" steuert.

Beispiel 1

C:\PS>test-computersecurechannel

True

Beschreibung
-----------
Dieser Befehl testet den sicheren Kanal zwischen dem lokalen Computer und der Domäne, der er hinzugefügt wurde.






Beispiel 2

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

True

Beschreibung
-----------
Dieser Befehl gibt einen bevorzugten Domänencontroller für den Test an.






Beispiel 3

C:\PS>Test-ComputerSecureChannel -repair

True

Beschreibung
-----------
Dieser Befehl setzt den sicheren Kanal zwischen dem lokalen Computer und der entsprechenden Domäne zurück.






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

Beschreibung
-----------
Bei diesem Befehl wird mit dem allgemeinen Verbose-Parameter eine ausführliche Meldung zum Vorgang angefordert. Weitere Informationen über den Verbose-Parameter finden Sie unter "about_CommonParameters".






Beispiel 5

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

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

Beschreibung
-----------
In diesem Beispiel wird die Verwendung von Test-ComputerSecureChannel zum Testen einer Verbindung veranschaulicht, bevor ein Skript ausgeführt wird, für das die Verbindung erforderlich ist.

Der erste Befehl erstellt mit dem Cmdlet "Set-Alias" einen Alias für den Cmdlet-Namen. So wird Speicherplatz gespart, und Tippfehler werden verhindert.

Die If-Anweisung überprüft den von Test-ComputerSecureChannel zurückgegebenen Wert, bevor ein Skript ausgeführt wird.






Siehe auch




Inhaltsverzeichnis