Dela via

Test-ComputerSecureChannel

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Default (Standard) 

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 Utförlig.

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

Anmärkning

Den här cmdleten fungerar bara på domänmedlemsdatorer. När du kör den på domänkontrollanter returneras falska positiva fel. Om du vill verifiera och återställa de säkra kanalerna för domänkontrollanter använder du netdom.exe eller nltest.exe.

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örligafinns 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 returnerar innan ett skript körs.

Parametrar

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 objekt som Get-Credential cmdleten 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 Repair för att reparera kanalen mellan datorn och domänen.

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.