Share via

Test-ComputerSecureChannel

  • Referens
Modul:
Microsoft.PowerShell.Management

Testar och reparerar den säkra kanalen mellan den lokala datorn och dess domän.

Syntax

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

Description

Cmdleten Test-ComputerSecureChannel verifierar att kanalen mellan den lokala datorn och dess domän fungerar korrekt genom att kontrollera statusen för dess förtroenderelationer. Om en anslutning misslyckas kan du använda parametern Reparera för att försöka återställa den.

Test-ComputerSecureChannel returnerar $True om kanalen fungerar korrekt och $False om den inte är det. Med det här resultatet kan du använda cmdleten i villkorsstyrda instruktioner i funktioner och skript. Om du vill få mer detaljerade testresultat använder du parametern Verbose .

Den här cmdleten fungerar ungefär som NetDom.exe. Både NetDom och Test-ComputerSecureChannel använda NetLogon-tjänsten för att utföra åtgärderna.

Exempel

Exempel 1: Testa en kanal mellan den lokala datorn och dess domän

Test-ComputerSecureChannel

Det här kommandot testar kanalen mellan den lokala datorn och domänen som den är ansluten till.

Exempel 2: Testa en kanal mellan den lokala datorn och en domänkontrollant

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

Det här kommandot anger en önskad domänkontrollant för testet.

Exempel 3: Återställa kanalen mellan den lokala datorn och dess domän

Test-ComputerSecureChannel -Repair

Det här kommandot återställer kanalen mellan den lokala datorn och dess domän.

Exempel 4: Visa detaljerad information om testet

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."

Det här kommandot använder den utförliga gemensamma parametern för att begära detaljerade meddelanden om åtgärden. Mer information om utförlig information finns i about_CommonParameters.

Exempel 5: Testa en anslutning innan du kör ett skript

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

Det här exemplet visar hur du använder Test-ComputerSecureChannel för att testa en anslutning innan du kör ett skript som kräver anslutningen.

-instruktionen if kontrollerar värdet som Test-ComputerSecureChannel returneras innan det kör ett skript.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt, till exempel ett som cmdleten Get-Credential returnerar. Som standard använder cmdleten den aktuella användarens autentiseringsuppgifter.

Parametern Credential är utformad för användning i kommandon som använder parametern Reparera för att reparera kanalen mellan datorn och domänen.

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

-Repair

Anger att den här cmdleten tar bort och sedan återskapar kanalen som upprättats av NetLogon-tjänsten. Använd den här parametern för att försöka återställa en anslutning som har misslyckats med testet.

Om du vill använda den här parametern måste den aktuella användaren vara medlem i gruppen Administratörer på den lokala datorn.

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

-Server

Anger vilken domänkontrollant som ska köra kommandot. Om den här parametern inte anges väljer den här cmdleten en standarddomänkontrollant för åtgärden.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

Boolean

Den här cmdleten returnerar $True om anslutningen fungerar korrekt och $False om den inte är det.

Kommentarer

  • Om du vill köra ett Test-ComputerSecureChannel kommando i Windows Vista och senare versioner av Windows-operativsystemet öppnar du Windows PowerShell med alternativet Kör som administratör.
  • Test-ComputerSecureChannel implementeras med hjälp av funktionen I_NetLogonControl2 , som styr olika aspekter av Netlogon-tjänsten.