Test-WSMan

Referens

Modul:: Microsoft.WSMan.Management

Testar om WinRM-tjänsten körs på en lokal dator eller en fjärrdator.

Syntax

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Test-WSMan skickar en identifieringsbegäran som avgör om WinRM-tjänsten körs på en lokal dator eller en fjärrdator. Om den testade datorn kör tjänsten visar cmdleten WS-Management identitetsschema, protokollversion, produktleverantör och produktversion för den testade tjänsten.

Exempel

Exempel 1: Fastställa status för WinRM-tjänsten

Test-WSMan

Det här kommandot avgör om WinRM-tjänsten körs på den lokala datorn eller på en fjärrdator.

Exempel 2: Fastställa status för WinRM-tjänsten på en fjärrdator

Test-WSMan -ComputerName "server01"

Det här kommandot avgör om WinRM-tjänsten körs på server01-datorn.

Exempel 3: Fastställa status för WinRM-tjänsten och operativsystemversionen

Test-WSMan -Authentication default

Det här kommandot testar om tjänsten WS-Management (WinRM) körs på den lokala datorn med hjälp av autentiseringsparametern.

Med hjälp av autentiseringsparametern kan Test-WSMan du returnera operativsystemversionen.

Exempel 4: Fastställa status för WinRM-tjänsten och OS-versionen på en fjärrdator

Test-WSMan -ComputerName "server01" -Authentication default

Det här kommandot testar om tjänsten WS-Management (WinRM) körs på datorn med namnet server01 med hjälp av autentiseringsparametern.

Med hjälp av autentiseringsparametern kan Test-WSMan du returnera operativsystemversionen.

Parametrar

-ApplicationName

Anger programnamnet i anslutningen. Standardvärdet för parametern ApplicationName är WSMAN. Den fullständiga identifieraren för fjärrslutpunkten har följande format:

<Transport>://<Server>:<Port>/<ApplicationName>

Exempelvis: http://server01:8080/WSMAN

Internet Information Services (IIS), som är värd för sessionen, vidarebefordrar begäranden med den här slutpunkten till det angivna programmet. Den här standardinställningen för WSMAN är lämplig för de flesta användningsområden. Den här parametern är avsedd att användas om många datorer upprättar fjärranslutningar till en dator som kör Windows PowerShell. I det här fallet är IIS värd för Web Services for Management (WS-Management) för effektivitet.

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

-Authentication

Anger vilken autentiseringsmekanism som ska användas på servern. De acceptabla värdena för den här parametern är:

Basic – Grundläggande är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.
Default – Använd autentiseringsmetoden som implementeras av WS-Management-protokollet. Det här är standardinställningen.
1 – Digest är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.
Kerberos – Klientdatorn och servern autentiseras ömsesidigt med hjälp av Kerberos-certifikat.
Negotiate – Förhandla är ett schema för utmaningssvar som förhandlar med servern eller proxyservern för att fastställa vilket schema som ska användas för autentisering. Det här parametervärdet möjliggör till exempel förhandling för att avgöra om Kerberos-protokollet eller NTLM används.
CredSSP – Använd Credential Security Support Provider-autentisering (CredSSP), vilket gör att användaren kan delegera autentiseringsuppgifter. Det här alternativet är utformat för kommandon som körs på en fjärrdator men samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.

Varning

CredSSP delegerar användarens autentiseringsuppgifter från den lokala datorn till en fjärrdator. Den här metoden ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan autentiseringsuppgifterna användas för att styra nätverkssessionen när autentiseringsuppgifterna skickas till den.

Viktigt

Om du inte anger parametern Test-WSManAutentisering skickas begäran till fjärrdatorn anonymt, utan att använda autentisering. Om begäran görs anonymt returneras ingen information som är specifik för operativsystemversionen. I stället visar denna cmdlet null-värden för operativsystemversionen och Service Pack-nivån (OS: 0.0.0 SP: 0.0).

Type:	Microsoft.WSMan.Management.AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Anger certifikatet för den digitala offentliga nyckeln (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.

Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. de fungerar inte med domänkonton.

Om du vill hämta ett tumavtryck för certifikat använder du Get-Item eller Get-ChildItem kommandot på enheten Windows PowerShell Cert: .

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

-ComputerName

Anger den dator som hanteringsåtgärden ska köras mot. Värdet kan vara ett fullständigt kvalificerat domännamn, ett NetBIOS-namn eller en IP-adress. Använd namnet på den lokala datorn, använd localhost eller använd en punkt (.) för att ange den lokala datorn. Den lokala datorn är standard. När fjärrdatorn finns i en annan domän än användaren måste du använda ett fullständigt kvalificerat domännamn. Du kan skicka ett värde för den här parametern till cmdleten .

Type:	String
Aliases:	cn
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren. Ange ett användarnamn, till exempel User01, Domain01\User01 eller User@Domain.com. Eller ange ett PSCredential-objekt , till exempel ett objekt som returneras av cmdleten Get-Credential . När du skriver ett användarnamn uppmanas du av den här cmdleten att ange ett lösenord.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Anger vilken port som ska användas när klienten ansluter till WinRM-tjänsten. När transporten är HTTP är standardporten 80. När transporten är HTTPS är standardporten 443.

När du använder HTTPS som transport måste värdet för parametern ComputerName matcha serverns certifikatnamn (CN).

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

-UseSSL

Anger att SSL-protokollet (Secure Sockets Layer) används för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.

WS-Management krypterar allt Windows PowerShell innehåll som överförs via nätverket. Med parametern UseSSL kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på den port som används för anslutningen och du anger den här parametern misslyckas kommandot.

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

Indata

None

Denna cmdlet accepterar inga indata.

Utdata