Get-PSSession
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 för 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 har skapats i 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 .
Anteckning
I Windows PowerShell 2.0 hämtar utan parametrar Get-PSSession
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: Få sessioner anslutna till den lokala datorn
Get-PSSession -ComputerName "localhost"
Det här kommandot hämtar de PSSessioner som är anslutna till den lokala datorn. Om du vill ange den lokala datorn skriver du 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: Få sessioner 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 de 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. Därefter sparas var och en av PSSessionerna i en separat variabel.
När PowerShell tilldelar en matris med objekt till en matris med variabler tilldelas 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 hjälp av dess instans-ID och sedan tar bort PSSessionen.
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 ansluter sedan 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 indikerar 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 öppet tillstånd 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 denna cmdlet tillåter omdirigering av den här anslutningen till en alternativ URI (Uniform Resource Identifier). Som standard omdirigerar PowerShell inte 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 används av sessionen.
Type: | String |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 (Credential Security Support Provider), där användarens autentiseringsuppgifter skickas till en fjärrdator som ska autentiseras, är utformad för kommandon som kräver autentisering på fler ä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.
Type: | AuthenticationMechanism |
Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Required: | False |
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 skapa den session 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ärränden för 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, localhost
eller en punkt (.
).
Anteckning
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.
Type: | String[] |
Aliases: | Cn |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
Anger namnet på en konfiguration. Den här cmdleten hämtar endast till sessioner som använder den angivna sessionskonfigurationen.
Ange ett konfigurationsnamn eller en fullständigt kvalificerad resurs-URI för en sessionskonfiguration. Om du bara anger konfigurationsnamnet läggs följande schema-URI till: http://schemas.microsoft.com/powershell
. Konfigurationsnamnet för en session lagras i egenskapen ConfigurationName 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 används av sessionen.
För ytterligare information om sessionskonfigurationer, se about_Session_Configurations.
Type: | String |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 en 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 porten 5985
för HTTP eller 5986
för HTTPS.
Om måldatorn omdirigerar anslutningen till en annan URI förhindrar PowerShell omdirigeringen såvida 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.
Type: | Uri[] |
Aliases: | URI, CU |
Position: | 0 |
Default value: | Http://localhost:5985/WSMAN |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerId
Anger en matris med ID:t 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 .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 cmdleten Get-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.
Anteckning
Mer information om SecureString-dataskydd finns i Hur säkert ä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.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Anger en matris med sessions-ID:t. Den här cmdleten hämtar endast sessioner med angivna ID:t. Skriv ett eller flera ID:er, 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.
Type: | Int32[] |
Position: | 0 |
Default value: | All sessions |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Anger en matris med instans-ID:t för sessioner. Den här cmdleten hämtar endast sessioner med angivna instans-ID:t.
Instans-ID är ett GUID som unikt identifierar en session på en lokal dator eller fjärrdator. 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.
Type: | Guid[] |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 det. 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.
Type: | Int32 |
Position: | Named |
Default value: | 5985, 5986 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 det har angetts. Annars upprättas standardvärdena av de alternativ som anges i sessionskonfigurationen.
Värdena för sessionsalternativ har företräde framför standardvärdena för sessioner som angetts i $PSSessionOption
inställningsvariabeln och i sessionskonfigurationen. De har dock inte företräde framför de högsta värden, kvoter eller gränser som angetts 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.
Type: | PSSessionOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Anger sessionstillstånd. Den här cmdleten hämtar endast sessioner i det angivna tillståndet. De godkända värdena för den här parametern är: All
, Opened
, Disconnected
, Closed
och Broken
. Standardvärdet är All
.
Värdet för sessionstillståndet är relativt till de aktuella sessionerna. Sessioner som inte har skapats i de aktuella sessionerna och inte är anslutna till den aktuella sessionen har tillståndet Disconnected
även när de är anslutna till en annan session.
Tillståndet för en session lagras i egenskapen Tillstånd för sessionen.
Den här parametern introducerades i Windows PowerShell 3.0.
Type: | SessionFilterState |
Accepted values: | All, Opened, Disconnected, Closed, Broken |
Position: | Named |
Default value: | All |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 datorn.
Den här parametern introducerades i Windows PowerShell 3.0.
Type: | Int32 |
Position: | Named |
Default value: | 32 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Anger att denna cmdlet 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | Guid[] |
Aliases: | VMGuid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Indata
None
Du kan inte skicka indata till denna cmdlet.
Utdata
Kommentarer
- Den här cmdleten
New-PSSession
hämtar PSSession-objekt för användarhanterade sessioner, till exempel de som skapas med hjälp av cmdletarna ,Enter-PSSession
ochInvoke-Command
. 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 tar emot slutet av 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 på 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 somGet-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 i förhållande 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 .
TillgänglighetsvärdetIngen anger att du kan ansluta till sessionen. Värdet Upptagen anger att du inte kan ansluta till PSSessionen 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 Uppräkning av RunspaceAvailability.