Freigeben über

Test-ComputerSecureChannel

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Default (Standard) 

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.

Hinweis

Dieses Cmdlet funktioniert nur auf Domänenmitgliedscomputern. Wenn Sie sie auf Domänencontrollern ausführen, werden falsch positive Fehler zurückgegeben. Um die sicheren Kanäle für Domänencontroller zu überprüfen und zurückzusetzen, verwenden netdom.exe Oder nltest.exe.

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 zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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.