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