Dela via

Get-PSSession

  • Referens
Modul:
Microsoft.PowerShell.Core

Hämtar PowerShell-sessioner på lokala datorer och fjärrdatorer.

Syntax

Get-PSSession
   [-Name <String[]>]
   [<CommonParameters>]
Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]
Get-PSSession
   [-InstanceId <Guid[]>]
   [<CommonParameters>]
Get-PSSession
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

Cmdleten Get-PSSession hämtar användarhanterade PowerShell-sessioner (PSSessioner) på lokala datorer och fjärrdatorer.

Från och med Windows PowerShell 3.0 lagras sessioner på datorerna i fjärrslutet av varje anslutning. Du kan använda parametrarna Get-PSSession ComputerName eller ConnectionUri för för att hämta de sessioner som ansluter till den lokala datorn eller fjärrdatorerna, även om de inte skapades under den aktuella sessionen.

Utan parametrar Get-PSSession hämtar alla sessioner som skapades i den aktuella sessionen.

Använd filtreringsparametrarna, inklusive Namn, ID, InstanceID, Tillstånd, ApplicationName och ConfigurationName för att välja bland de sessioner som Get-PSSession returneras.

Använd de återstående parametrarna för att konfigurera den tillfälliga anslutning där Get-PSSession kommandot körs när du använder parametrarna ComputerName eller ConnectionUri .

Kommentar

I Windows PowerShell 2.0, utan parametrar, Get-PSSession hämtas alla sessioner som skapades i den aktuella sessionen. Parametern ComputerName hämtar sessioner som skapades i den aktuella sessionen och ansluter till den angivna datorn.

Mer information om PowerShell-sessioner finns i about_PSSessions.

Exempel

Exempel 1: Hämta sessioner som skapats i den aktuella sessionen

Get-PSSession

Det här kommandot hämtar alla PSSessioner som skapades i den aktuella sessionen. Det får inte PSSessioner som har skapats i andra sessioner eller på andra datorer, även om de ansluter till den här datorn.

Exempel 2: Hämta sessioner som är anslutna till den lokala datorn

Get-PSSession -ComputerName "localhost"

Det här kommandot hämtar PSSessions som är anslutna till den lokala datorn. Ange den lokala datorn genom att skriva datornamnet, localhost eller en punkt (.)

Kommandot returnerar alla sessioner på den lokala datorn, även om de har skapats i olika sessioner eller på olika datorer.

Exempel 3: Hämta sessioner som är anslutna till en dator

Get-PSSession -ComputerName "Server02"

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  2 Session3        Server02       Disconnected  ITTasks                       Busy
  1 ScheduledJobs   Server02       Opened        Microsoft.PowerShell     Available
  3 Test            Server02       Disconnected  Microsoft.PowerShell          Busy

Det här kommandot hämtar PSSessioner som är anslutna till Server02-datorn.

Kommandot returnerar alla sessioner på Server02, även om de har skapats i olika sessioner eller på olika datorer.

Utdata visar att två av sessionerna har ett Disconnected tillstånd och en Busy tillgänglighet. De skapades i olika sessioner och används för närvarande. Sessionen ScheduledJobs , som är Opened och Available, skapades i den aktuella sessionen.

Exempel 4: Spara resultatet av det här kommandot

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

Det här exemplet visar hur du sparar resultatet av ett Get-PSSession kommando i flera variabler.

Det första kommandot använder cmdleten New-PSSession för att skapa PSSessioner på tre fjärrdatorer.

Det andra kommandot använder en Get-PSSession cmdlet för att hämta de tre PSSessionerna. Sedan sparas var och en av PSSessionerna i en separat variabel.

När PowerShell tilldelar en matris med objekt till en matris med variabler tilldelar den det första objektet till den första variabeln, det andra objektet till den andra variabeln och så vidare. Om det finns fler objekt än variabler tilldelas alla återstående objekt till den sista variabeln i matrisen. Om det finns fler variabler än objekt används inte de extra variablerna.

Exempel 5: Ta bort en session med hjälp av ett instans-ID

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

Det här exemplet visar hur du hämtar en PSSession med dess instans-ID och sedan tar bort PSSession.

Det första kommandot hämtar alla PSSessioner som skapades i den aktuella sessionen. Den skickar PSSessions till cmdleten Format-Table , som visar egenskaperna ComputerName och InstanceID för varje PSSession.

Det andra kommandot använder cmdleten Get-PSSession för att hämta en viss PSSession och för att spara den i variabeln $s . Kommandot använder parametern InstanceID för att identifiera PSSession.

Det tredje kommandot använder cmdleten Remove-PSSession för att ta bort PSSession i variabeln $s .

Exempel 6: Hämta en session som har ett visst namn

Kommandona i det här exemplet hittar en session som har ett visst namnformat och använder en viss sessionskonfiguration och sedan ansluter till sessionen. Du kan använda ett kommando som det här för att hitta en session där en kollega startade en uppgift och ansluta för att slutföra uppgiften.

Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  3 BackupJob04     Server02        Disconnected        ITTasks                  None

$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 5 BackupJob04     Server02        Opened        ITTasks                  Available

Det första kommandot hämtar sessioner på fjärrdatorerna Server02 och Server12 som har namn som börjar med BackupJob och använder ITTasks sessionskonfigurationen. Kommandot använder parametern Namn för att ange namnmönstret och parametern ConfigurationName för att ange sessionskonfigurationen. Värdet för parametern SessionOption är en hash-tabell som anger värdet för OperationTimeout till 240000 millisekunder (4 minuter). Den här inställningen ger kommandot mer tid att slutföra. Parametrarna ConfigurationName och SessionOption används för att konfigurera de tillfälliga sessioner där cmdleten Get-PSSession körs på varje dator. Utdata visar att kommandot returnerar BackupJob04 sessionen. Sessionen är frånkopplad och tillgängligheten är None, vilket anger att den inte används.

Det andra kommandot använder cmdleten Get-PSSession för att komma till BackupJob04 sessionen och cmdleten Connect-PSSession för att ansluta till sessionen. Kommandot sparar sessionen i variabeln $s .

Det tredje kommandot hämtar sessionen i variabeln $s . Utdata visar att Connect-PSSession kommandot lyckades. Sessionen är i tillståndet Öppnad och är tillgänglig för användning.

Exempel 7: Hämta en session med hjälp av dess ID

Get-PSSession -Id 2

Det här kommandot hämtar PSSession med ID 2. Eftersom värdet för ID-egenskapen endast är unikt i den aktuella sessionen är ID-parametern endast giltig för lokala kommandon.

Parametrar

-AllowRedirection

Anger att den här cmdleten tillåter omdirigering av den här anslutningen till en alternativ URI (Uniform Resource Identifier). Som standard omdirigerar Inte PowerShell anslutningar.

Den här parametern konfigurerar den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ConnectionUri .

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationName

Anger namnet på ett program. Den här cmdleten ansluter endast till sessioner som använder det angivna programmet.

Ange programnamnssegmentet för anslutnings-URI:n. I följande anslutnings-URI är till exempel programnamnet WSMan: http://localhost:5985/WSMAN. Programnamnet för en session lagras i egenskapen Runspace.ConnectionInfo.AppName för sessionen.

Värdet för den här parametern används för att välja och filtrera sessioner. Det ändrar inte programmet som sessionen använder.

Typ:String
Position:Named
Standardvärde:All sessions
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Authentication

Anger den mekanism som används för att autentisera autentiseringsuppgifter för den session där Get-PSSession kommandot körs.

Den här parametern konfigurerar den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ComputerName eller ConnectionUri .

De acceptabla värdena för den här parametern är:

  • Default
  • Basic
  • CredSSP
  • Digest
  • Kerberos
  • Negotiate
  • NegotiateWithImplicitCredential.

Standardvärdet är Default.

Mer information om värdena för den här parametern finns i AuthenticationMechanism Enumeration.

Varning

CredSSP-autentisering (CredSSP), där användarens autentiseringsuppgifter skickas till en fjärrdator som ska autentiseras, är utformad för kommandon som kräver autentisering på mer än en resurs, till exempel åtkomst till en fjärrnätverksresurs. Den här mekanismen ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan de autentiseringsuppgifter som skickas till den användas för att styra nätverkssessionen.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:AuthenticationMechanism
Godkända värden:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Standardvärde:Default
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CertificateThumbprint

Anger det digitala offentliga nyckelcertifikatet (X509) för ett användarkonto som har behörighet att skapa sessionen där Get-PSSession kommandot körs. Ange certifikatets tumavtryck.

Den här parametern konfigurerar den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ComputerName eller ConnectionUri .

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 ett Get-Item eller Get-ChildItem -kommando på PowerShell-enheten Cert: .

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Hämtar de sessioner som ansluter till de angivna datorerna. Jokertecken tillåts inte. Det finns inget standardvärde.

Från och med Windows PowerShell 3.0 lagras PSSession-objekt på datorerna i fjärrslutet av varje anslutning. För att hämta sessionerna på de angivna datorerna skapar PowerShell en tillfällig anslutning till varje dator och kör ett Get-PSSession kommando.

Ange NetBIOS-namnet, en IP-adress eller ett fullständigt domännamn på en eller flera datorer. Om du vill ange den lokala datorn skriver du datornamnet, localhosteller en punkt (.).

Kommentar

Den här parametern hämtar endast sessioner från datorer som kör Windows PowerShell 3.0 eller senare versioner av PowerShell. Tidigare versioner lagrar inte sessioner.

Typ:String[]
Alias:Cn
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConfigurationName

Anger namnet på en konfiguration. Den här cmdleten kommer endast till sessioner som använder den angivna sessionskonfigurationen.

Ange ett konfigurationsnamn eller den fullständigt kvalificerade resurs-URI:n för en sessionskonfiguration. Om du bara anger konfigurationsnamnet förbereds följande schema-URI: http://schemas.microsoft.com/powershell. Konfigurationsnamnet för en session lagras i configurationName-egenskapen för sessionen.

Värdet för den här parametern används för att välja och filtrera sessioner. Den ändrar inte sessionskonfigurationen som sessionen använder.

För ytterligare information om sessionskonfigurationer, se about_Session_Configurations.

Typ:String
Position:Named
Standardvärde:All sessions
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConnectionUri

Anger en URI som definierar anslutningsslutpunkten för den tillfälliga session där Get-PSSession kommandot körs. URI:n måste vara fullständigt kvalificerad.

Den här parametern konfigurerar den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ConnectionUri .

Formatet för den här strängen är:

<Transport>://<ComputerName>:<Port\>/<ApplicationName>

Standardvärdet är: http://localhost:5985/WSMAN.

Om du inte anger en ConnectionUri kan du använda parametrarna UseSSL, ComputerName, Port och ApplicationName för att ange ConnectionURI-värdena . Giltiga värden för transportsegmentet för URI:n är HTTP och HTTPS. Om du anger en anslutnings-URI med ett transportsegment, men inte anger någon port, skapas sessionen med standardportar: 80 för HTTP och 443 för HTTPS. Om du vill använda standardportarna för PowerShell-fjärrkommunikation anger du port 5985 för HTTP eller 5986 HTTPS.

Om måldatorn omdirigerar anslutningen till en annan URI förhindrar PowerShell omdirigeringen om du inte använder parametern AllowRedirection i kommandot.

Den här parametern introducerades i Windows PowerShell 3.0.

Den här parametern hämtar endast sessioner från datorer som kör Windows PowerShell 3.0 eller senare versioner av Windows PowerShell. Tidigare versioner lagrar inte sessioner.

Typ:Uri[]
Alias:URI, CU
Position:0
Standardvärde:Http://localhost:5985/WSMAN
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ContainerId

Anger en matris med ID:er för containrar. Den här cmdleten startar en interaktiv session med var och en av de angivna containrarna. docker ps Använd kommandot för att hämta en lista över container-ID:t. Mer information finns i hjälpen för kommandot docker ps .

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Credential

Anger en användarautentiseringsuppgift. Den här cmdleten kör kommandot med den angivna användarens behörigheter. Ange ett användarkonto som har behörighet att ansluta till fjärrdatorn och köra ett Get-PSSession kommando. Standard är den aktuella användaren.

Ange ett användarnamn, till exempel eller Domain01\User01, eller ange ett PSCredential-objekt som User01 genereras av cmdletenGet-Credential. Om du skriver ett användarnamn uppmanas du att ange lösenordet.

Autentiseringsuppgifter lagras i ett PSCredential-objekt och lösenordet lagras som en SecureString.

Kommentar

Mer information om SecureString-dataskydd finns i Hur säker är SecureString?.

Den här parametern konfigurerar till den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ComputerName eller ConnectionUri .

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger en matris med sessions-ID:t. Den här cmdleten hämtar endast sessioner med angivna ID:er. Skriv ett eller flera ID:t, avgränsade med kommatecken eller använd intervalloperatorn (..) för att ange ett intervall med ID:er. Du kan inte använda ID-parametern tillsammans med parametern ComputerName .

Ett ID är ett heltal som unikt identifierar användarhanterade sessioner i den aktuella sessionen. Det är lättare att komma ihåg och skriva än InstanceId, men det är bara unikt i den aktuella sessionen. ID:t för en session lagras i ID-egenskapen för sessionen.

Typ:Int32[]
Position:0
Standardvärde:All sessions
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InstanceId

Anger en matris med instans-ID:t för sessioner. Den här cmdleten hämtar endast sessioner med angivna instans-ID:er.

Instans-ID:t är ett GUID som unikt identifierar en session på en lokal eller fjärransluten dator. InstanceID är unikt, även om du har flera sessioner som körs i PowerShell.

Instans-ID för en session lagras i egenskapen InstanceID för sessionen.

Typ:Guid[]
Position:Named
Standardvärde:All sessions
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger en matris med sessionsnamn. Den här cmdleten hämtar endast de sessioner som har de angivna egna namnen. Jokertecken tillåts.

Det egna namnet på en session lagras i egenskapen Namn för sessionen.

Typ:String[]
Position:Named
Standardvärde:All sessions
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Port

Anger den angivna nätverksporten som används för den tillfälliga anslutning där Get-PSSession kommandot körs. Om du vill ansluta till en fjärrdator måste fjärrdatorn lyssna på porten som anslutningen använder. Standardportarna är 5985, som är WinRM-porten för HTTP och 5986, som är WinRM-porten för HTTPS.

Innan du använder en alternativ port måste du konfigurera WinRM-lyssnaren på fjärrdatorn så att den lyssnar på den porten. Om du vill konfigurera lyssnaren skriver du följande två kommandon i PowerShell-prompten:

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

Den här parametern konfigurerar till den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ComputerName eller ConnectionUri .

Använd inte portparametern om du inte måste. Portuppsättningen i kommandot gäller för alla datorer eller sessioner där kommandot körs. En alternativ portinställning kan förhindra att kommandot körs på alla datorer.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:Int32
Position:Named
Standardvärde:5985, 5986
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SessionOption

Anger avancerade alternativ för sessionen. Ange ett SessionOption-objekt , till exempel ett objekt som du skapar med hjälp av cmdleten New-PSSessionOption eller en hash-tabell där nycklarna är sessionsalternativnamn och värdena är sessionsalternativvärden.

Standardvärdena för alternativen bestäms av värdet för $PSSessionOption inställningsvariabeln, om den har angetts. Annars upprättas standardvärdena av de alternativ som anges i sessionskonfigurationen.

Sessionsalternativvärdena har företräde framför standardvärden för sessioner som anges i inställningsvariabeln $PSSessionOption och i sessionskonfigurationen. De har dock inte företräde framför de högsta värden, kvoter eller gränser som anges i sessionskonfigurationen.

En beskrivning av sessionsalternativen, inklusive standardvärdena, finns i New-PSSessionOption. Information om inställningsvariabeln finns i $PSSessionOption about_Preference_Variables. För ytterligare information om sessionskonfigurationer, se about_Session_Configurations.

Typ:PSSessionOption
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-State

Anger sessionstillstånd. Den här cmdleten hämtar endast sessioner i det angivna tillståndet. De acceptabla värdena för den här parametern är: All, Opened, Disconnected, Closedoch Broken. Standardvärdet är All.

Sessionstillståndsvärdet är i förhållande till de aktuella sessionerna. Sessioner som inte har skapats i de aktuella sessionerna och som inte är anslutna till den aktuella sessionen har statusen Disconnected även när de är anslutna till en annan session.

Tillståndet för en session lagras i sessionens tillståndsegenskap.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:SessionFilterState
Godkända värden:All, Opened, Disconnected, Closed, Broken
Position:Named
Standardvärde:All
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ThrottleLimit

Anger det maximala antalet samtidiga anslutningar som kan upprättas för att köra Get-PSSession kommandot. Om du utelämnar den här parametern eller anger värdet 0 (noll) används standardvärdet , 32. Begränsningsgränsen gäller endast för det aktuella kommandot, inte för sessionen eller på datorn.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:Int32
Position:Named
Standardvärde:32
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseSSL

Anger att den här cmdleten använder SSL-protokollet (Secure Sockets Layer) för att upprätta anslutningen där Get-PSSession kommandot körs. Som standard används inte SSL. Om du använder den här parametern, men SSL inte är tillgängligt på porten som används för kommandot, misslyckas kommandot.

Den här parametern konfigurerar den tillfälliga anslutning som skapas för att köra ett Get-PSSession kommando med parametern ComputerName .

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMId

Anger en matris med ID för virtuella datorer. Den här cmdleten startar en interaktiv session med var och en av de angivna virtuella datorerna. Om du vill se de virtuella datorer som är tillgängliga för dig använder du följande kommando:

Get-VM | Select-Object -Property Name, ID

Typ:Guid[]
Alias:VMGuid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMName

Anger en matris med namn på virtuella datorer. Den här cmdleten startar en interaktiv session med var och en av de angivna virtuella datorerna. Om du vill se de virtuella datorer som är tillgängliga för dig använder du cmdleten Get-VM .

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

None

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

Utdata

PSSession

Kommentarer

PowerShell innehåller följande alias för Get-PSSession:

  • Alla plattformar:

    • gsn

  • Den här cmdleten hämtar PSSession-objekt för användarhanterade sessioner, till exempel de som skapas med hjälp av cmdletarna , Enter-PSSessionoch Invoke-Command .New-PSSession Den hämtar inte den systemhanterade session som skapas när du startar PowerShell.

  • Från och med Windows PowerShell 3.0 lagras PSSession-objekt på den dator som finns på serversidan eller som tar emot en anslutning. För att hämta de sessioner som lagras på den lokala datorn eller en fjärrdator upprättar PowerShell en tillfällig session till den angivna datorn och kör frågekommandon i sessionen.

  • Om du vill hämta sessioner som ansluter till en fjärrdator använder du parametrarna ComputerName eller ConnectionUri för att ange fjärrdatorn. Om du vill filtrera de sessioner som Get-PSSession hämtas använder du parametrarna Namn, ID, InstanceID och Tillstånd . Använd de återstående parametrarna för att konfigurera den tillfälliga session som Get-PSSession använder.

  • När du använder parametrarna Get-PSSession ComputerName eller ConnectionUri hämtar endast sessioner från datorer som kör Windows PowerShell 3.0 och senare versioner av PowerShell.

  • Värdet för egenskapen State för en PSSession är relativ till den aktuella sessionen. Därför innebär värdet Frånkopplad att PSSession inte är ansluten till den aktuella sessionen. Det innebär dock inte att PSSession är frånkopplad från alla sessioner. Den kan vara ansluten till en annan session. Om du vill ta reda på om du kan ansluta eller återansluta till PSSession från den aktuella sessionen använder du egenskapen Tillgänglighet .

Ett tillgänglighetsvärde på Ingen anger att du kan ansluta till sessionen. Värdet Upptagen anger att du inte kan ansluta till PSSession eftersom den är ansluten till en annan session.

Mer information om värdena för egenskapen State för sessioner finns i RunspaceState Enumeration.

Mer information om värdena för egenskapen Tillgänglighet för sessioner finns i RunspaceAvailability Enumeration.