Freigeben über

Test-ComputerSecureChannel

  • Referenz
Modul:
Microsoft.PowerShell.Management

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

Syntax

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Test-ComputerSecureChannel überprüft, ob der Kanal zwischen dem lokalen Computer und seiner Domäne ordnungsgemäß funktioniert, indem der Status seiner Vertrauensbeziehungen überprüft wird. Wenn eine Verbindung fehlschlägt, können Sie den Parameter Repair verwenden, um sie wiederherzustellen.

Test-ComputerSecureChannel gibt $True zurück, wenn der Kanal ordnungsgemäß funktioniert und $False, wenn dies nicht der Richtige ist. Mit diesem Ergebnis können Sie das Cmdlet in bedingten Anweisungen in Funktionen und Skripts verwenden. Um detailliertere Testergebnisse zu erhalten, verwenden Sie den parameter Verbose.

Dieses Cmdlet funktioniert ähnlich wie NetDom.exe. Sowohl NetDom als auch Test-ComputerSecureChannel verwenden den NetLogon Dienst, um die Aktionen auszuführen.

Beispiele

Beispiel 1: Testen eines Kanals zwischen dem lokalen Computer und seiner Domäne

Test-ComputerSecureChannel

Dieser Befehl testet den Kanal zwischen dem lokalen Computer und der Domäne, mit der er verbunden ist.

Beispiel 2: Testen eines Kanals zwischen dem lokalen Computer und einem Domänencontroller

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

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

Beispiel 3: Zurücksetzen des Kanals zwischen dem lokalen Computer und seiner Domäne

Test-ComputerSecureChannel -Repair

Mit diesem Befehl wird der Kanal zwischen dem lokalen Computer und seiner Domäne zurückgesetzt.

Beispiel 4: Anzeigen detaillierter Informationen zum 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."

Dieser Befehl verwendet die Verbose allgemeinen Parameter, um detaillierte Nachrichten zum Vorgang anzufordern. Weitere Informationen zu ausführlichenfinden Sie unter about_CommonParameters.

Beispiel 5: Testen einer Verbindung vor dem Ausführen eines Skripts

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

In diesem Beispiel wird gezeigt, wie Sie Test-ComputerSecureChannel verwenden, um eine Verbindung zu testen, bevor Sie ein Skript ausführen, das die Verbindung erfordert.

Die if-Anweisung überprüft den Wert, den Test-ComputerSecureChannel zurückgibt, bevor ein Skript ausgeführt wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein Objekt, das vom cmdlet Get-Credential zurückgegeben wird. Standardmäßig verwendet das Cmdlet die Anmeldeinformationen des aktuellen Benutzers.

Der parameter Credential dient der Verwendung in Befehlen, die den Parameter Repair verwenden, um den Kanal zwischen dem Computer und der Domäne zu reparieren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Repair

Gibt an, dass dieses Cmdlet entfernt und anschließend den vom NetLogon-Dienst eingerichteten Kanal neu erstellt. Verwenden Sie diesen Parameter, um eine Verbindung wiederherzustellen, bei der der Test fehlgeschlagen ist.

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Server

Gibt den Domänencontroller an, der den Befehl ausführen soll. Wenn dieser Parameter nicht angegeben ist, wählt dieses Cmdlet einen Standarddomänencontroller für den Vorgang aus.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

Boolean

Dieses Cmdlet gibt $True zurück, wenn die Verbindung ordnungsgemäß funktioniert und wenn dies nicht der Fall ist, $False.

Hinweise

  • Um einen Test-ComputerSecureChannel Befehl unter Windows Vista und höheren Versionen des Windows-Betriebssystems auszuführen, öffnen Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen".
  • Test-ComputerSecureChannel wird mithilfe der I_NetLogonControl2-Funktion implementiert, die verschiedene Aspekte des Netlogon-Diensts steuert.