Freigeben über

Test-ComputerSecureChannel

  • Referenz
Modul:
Microsoft.PowerShell.Management

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

Syntax

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

Beschreibung

Das Test-ComputerSecureChannel Cmdlet ü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. Durch dieses Ergebnis können Sie das Cmdlet in bedingten Anweisungen in Features und Skripts verwenden. Verwenden Sie den Verbose-Parameter , um detailliertere Testergebnisse zu erhalten.

Dieses Cmdlet funktioniert ähnlich wie NetDom.exe. Sowohl NetDom als Test-ComputerSecureChannel auch der NetLogon-Dienst verwenden, 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 den ausführlichen allgemeinen Parameter, um detaillierte Meldungen zum Vorgang anzufordern. Weitere Informationen zu "Ausführlich" finden 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 Test-ComputerSecureChannel Sie eine Verbindung testen, bevor Sie ein Skript ausführen, das die Verbindung erfordert.

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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 " ist für die Verwendung in Befehlen vorgesehen, 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 %%amp;quot;Administratoren%%amp;quot; 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 geschieht, 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

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

Boolean

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

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.