Connect-WSMan

Ansluter till WinRM-tjänsten på en fjärrdator.

Syntax

Connect-WSMan
       [-ApplicationName <String>]
       [[-ComputerName] <String>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-UseSSL]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]
Connect-WSMan
       [-ConnectionURI <Uri>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]

Description

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

Cmdleten Connect-WSMan ansluter till WinRM-tjänsten på en fjärrdator och upprättar en beständig anslutning till fjärrdatorn. Du kan använda den här cmdleten i kontexten för WSMan-providern för att ansluta till WinRM-tjänsten på en fjärrdator. Du kan dock också använda den här cmdleten för att ansluta till WinRM-tjänsten på en fjärrdator innan du byter till WSMan-providern. Fjärrdatorn visas i WSMan-providerns rotkatalog.

Explicita autentiseringsuppgifter krävs när klient- och serverdatorerna finns i olika domäner eller arbetsgrupper.

Information om hur du kopplar från WinRM-tjänsten på en fjärrdator finns i cmdleten Disconnect-WSMan .

Exempel

Exempel 1: Anslut till en fjärrdator

PS C:\> Connect-WSMan -ComputerName "server01"
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Det här kommandot skapar en anslutning till fjärrserver01-datorn.

Cmdleten Connect-WSMan används vanligtvis i kontexten för WSMan-providern för att ansluta till en fjärrdator, i det här fallet server01-datorn. Du kan dock använda cmdleten för att upprätta anslutningar till fjärrdatorer innan du ändrar till WSMan-providern. Dessa anslutningar visas i listan ComputerName .

Exempel 2: Anslut till en fjärrdator med administratörsautentiseringsuppgifter

PS C:\> $cred = Get-Credential Administrator
PS C:\> Connect-WSMan -ComputerName "server01" -Credential $cred
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Det här kommandot skapar en anslutning till fjärrsystemservern01 med autentiseringsuppgifterna för administratörskontot.

Det första kommandot använder cmdleten Get-Credential för att hämta administratörsautentiseringsuppgifterna och lagrar dem sedan i variabeln $cred . Get-Credential uppmanar dig att ange ett lösenord för användarnamn och lösenord via en dialogruta eller på kommandoraden, beroende på systemets registerinställningar.

Det andra kommandot använder parametern Credential för att skicka autentiseringsuppgifterna som lagras i $cred till Connect-WSMan. Connect-WSMan ansluter sedan till fjärrsystemservern01 med autentiseringsuppgifterna administratör.

Exempel 3: Anslut till en fjärrdator via en angiven port

PS C:\> Connect-WSMan -ComputerName "server01" -Port 80
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Det här kommandot skapar en anslutning till fjärrservern01-datorn via port 80.

Exempel 4: Ansluta till en fjärrdator med hjälp av anslutningsalternativ

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

I det här exemplet skapas en anslutning till fjärrdatorn server01 med hjälp av de anslutningsalternativ som definieras i New-WSManSessionOption kommandot .

Det första kommandot använder New-WSManSessionOption för att lagra en uppsättning alternativ för anslutningsinställningar i variabeln $a . I det här fallet anger sessionsalternativen en anslutningstid på 30 sekunder (30 000 millisekunder).

Det andra kommandot använder parametern SessionOption för att skicka de autentiseringsuppgifter som lagras i variabeln $a till Connect-WSMan. Connect-WSMan Ansluter sedan till fjärrservern01-datorn med hjälp av de angivna sessionsalternativen.

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.
  • Digest – Sammanfattning ä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.

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 certifikatet Get-Item använder du kommandot eller Get-ChildItem på enheten Windows PowerShell Certifikat: .

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:False
Accept wildcard characters:False

-ConnectionURI

Anger anslutningsslutpunkten. Formatet för den här strängen är följande:

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

Följande sträng är ett korrekt formaterat värde för den här parametern:

http://Server01:8080/WSMAN

URI:n måste vara fullständigt kvalificerad.

Type:Uri
Position:Named
Default value:None
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. Standard är den aktuella användaren. Ange ett användarnamn, till exempel User01, Domain01\User01eller 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

-OptionSet

Anger en uppsättning växlar till en tjänst för att ändra eller förfina typen av begäran. Dessa liknar växlar som används i kommandoradsgränssnitt eftersom de är tjänstspecifika. Valfritt antal alternativ kan anges.

I följande exempel visas den syntax som skickar värdena 1, 2 och 3 för parametrarna a, b och c:

-OptionSet @{a=1;b=2;c=3}

Type:Hashtable
Aliases:os
Position:Named
Default value:None
Accept pipeline input:False
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). Men om parametern SkipCNCheck anges som en del av parametern SessionOption behöver certifikatets gemensamma namn på servern inte matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.

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

-SessionOption

Anger utökade alternativ för den WS-Management sessionen. Ange ett SessionOption-objekt som du skapar med hjälp av cmdleten New-WSManSessionOption . Om du vill ha mer information om vilka alternativ som är tillgängliga skriver du Get-Help New-WSManSessionOption.

Type:Microsoft.WSMan.Management.SessionOption
Aliases:so
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å porten 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

None

Denna cmdlet genererar inga utdata.

Kommentarer

Du kan köra hanteringskommandon eller frågehanteringsdata på en fjärrdator utan att skapa en WS-Management session. Du kan göra detta med hjälp av parametrarnaInvoke-WSManAction ComputerName för och Get-WSManInstance. När du använder parametern ComputerName skapar Windows PowerShell en tillfällig anslutning som används för det enskilda kommandot. När kommandot har körts stängs anslutningen.