Delen via

Test-ComputerSecureChannel

  • Referentie
Module:
Microsoft.PowerShell.Management

Test en herstelt het beveiligde kanaal tussen de lokale computer en het bijbehorende domein.

Syntax

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

Description

De cmdlet Test-ComputerSecureChannel controleert of het kanaal tussen de lokale computer en het bijbehorende domein correct werkt door de status van de vertrouwensrelaties te controleren. Als een verbinding mislukt, kunt u de parameter Herstellen gebruiken om deze te herstellen.

Test-ComputerSecureChannel retourneert $True of het kanaal correct werkt en $False als dat niet het juiste is. Met dit resultaat kunt u de cmdlet gebruiken in voorwaardelijke instructies in functies en scripts. Als u meer gedetailleerde testresultaten wilt krijgen, gebruikt u de parameter Uitgebreid .

Deze cmdlet werkt vergelijkbaar met NetDom.exe. Zowel NetDom als Test-ComputerSecureChannel gebruiken de NetLogon-service om de acties uit te voeren.

Voorbeelden

Voorbeeld 1: Een kanaal testen tussen de lokale computer en het bijbehorende domein

PS C:\> Test-ComputerSecureChannel
True

Met deze opdracht wordt het kanaal tussen de lokale computer en het domein waaraan het is gekoppeld getest.

Voorbeeld 2: Een kanaal testen tussen de lokale computer en een domeincontroller

PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Met deze opdracht geeft u een voorkeursdomeincontroller voor de test op.

Voorbeeld 3: Het kanaal tussen de lokale computer en het bijbehorende domein opnieuw instellen

PS C:\> Test-ComputerSecureChannel -Repair
True

Met deze opdracht wordt het kanaal tussen de lokale computer en het bijbehorende domein opnieuw ingesteld.

Voorbeeld 4: Gedetailleerde informatie over de test weergeven

PS C:\> 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."

Deze opdracht maakt gebruik van de algemene parameter Uitgebreid om gedetailleerde berichten over de bewerking op te vragen. Zie about_CommonParameters voor meer informatie over Uitgebreid.

Voorbeeld 5: Een verbinding testen voordat u een script uitvoert

PS C:\> Set-Alias tcsc Test-ComputerSecureChannel
if (!(tcsc))
{Write-Host "Connection failed. Reconnect and retry."}
else { &(.\Get-Servers.ps1) }

In dit voorbeeld ziet u hoe u Test-ComputerSecureChannel gebruikt om een verbinding te testen voordat u een script uitvoert waarvoor de verbinding is vereist.

De eerste opdracht gebruikt de cmdlet Set-Alias om een alias te maken voor de naam van de cmdlet. Dit bespaart ruimte en voorkomt typfouten.

De if-instructie controleert de waarde die Test-ComputerSecureChannel retourneert voordat een script wordt uitgevoerd.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd. De cmdlet gebruikt standaard de referenties van de huidige gebruiker.

De referentieparameter is ontworpen voor gebruik in opdrachten die de parameter Repair gebruiken om het kanaal tussen de computer en het domein te herstellen.

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

-Repair

Hiermee wordt aangegeven dat met deze cmdlet het kanaal dat door de NetLogon-service is ingesteld, wordt verwijderd en opnieuw wordt opgebouwd. Gebruik deze parameter om een verbinding te herstellen waarvoor de test is mislukt.

Als u deze parameter wilt gebruiken, moet de huidige gebruiker lid zijn van de groep Administrators op de lokale computer.

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

-Server

Hiermee geeft u de domeincontroller om de opdracht uit te voeren. Als deze parameter niet is opgegeven, selecteert deze cmdlet een standaarddomeincontroller voor de bewerking.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

None

U kunt geen invoer doorspezen naar deze cmdlet.

Uitvoerwaarden

Boolean

Deze cmdlet retourneert $True of de verbinding correct werkt en $False als dit niet het juiste is.

Notities

  • Als u een opdracht Test-ComputerSecureChannel wilt uitvoeren op Windows Vista en latere versies van het Windows-besturingssysteem, opent u Windows PowerShell met behulp van de optie Als administrator uitvoeren.
  • Test-ComputerSecureChannel wordt geïmplementeerd met behulp van de functie I_NetLogonControl2 , waarmee verschillende aspecten van de Netlogon-service worden beheerd.