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 dessen Aufgaben ordnungsgemäß funktioniert Standard 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 dessen Aufgaben Standard

Test-ComputerSecureChannel

Dieser Befehl testet den Kanal zwischen dem lokalen Computer und der Do Standard mit dem er verbunden ist.

Beispiel 2: Testen eines Kanals zwischen dem lokalen Computer und einem Do Standard controller

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 deren Aufgaben Standard

Test-ComputerSecureChannel -Repair

Mit diesem Befehl wird der Kanal zwischen dem lokalen Computer und dessen Aufgaben zurückgesetzt Standard.

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 "Do Standard 01\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" wurde für Befehle entwickelt, die den Parameter "Repair" verwenden, um den Kanal zwischen dem Computer und dem Do Standard zu reparieren.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Server

Gibt den Do Standard-Controller an, um den Befehl auszuführen. Wenn dieser Parameter nicht angegeben ist, wählt dieses Cmdlet einen Standard-Do Standard Controller für den Vorgang aus.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.