Get-PSSession

Modul:

Microsoft.PowerShell.Core

Získá relace PowerShellu na místních a vzdálených počítačích.

Syntaxe

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

Rutina Get-PSSession získá relace PowerShellu spravované uživatelem (PSSession) na místních a vzdálených počítačích.

Počínaje windows PowerShellem 3.0 se relace ukládají na počítačích na vzdáleném konci každého připojení. Parametry ComputerName nebo ConnectionUri Get-PSSession můžete použít k získání relací, které se připojují k místnímu počítači nebo vzdáleným počítačům, i když nebyly vytvořeny v aktuální relaci.

Bez parametrů Get-PSSession získá všechny relace vytvořené v aktuální relaci.

Pomocí parametrů filtrování, včetně name, ID, InstanceID, State, ApplicationName a ConfigurationName, vyberte z relací, které Get-PSSession vrací.

Zbývající parametry použijte ke konfiguraci dočasného připojení, ve kterém se Get-PSSession příkaz spustí při použití parametrů ComputerName nebo ConnectionUri .

Poznámka:

Ve Windows PowerShellu 2.0 bez parametrů Get-PSSession získá všechny relace vytvořené v aktuální relaci. Parametr ComputerName získá relace vytvořené v aktuální relaci a připojí se k zadanému počítači.

Další informace o relacích PowerShellu najdete v tématu about_PSSessions.

Příklady

Příklad 1: Získání relací vytvořených v aktuální relaci

Get-PSSession

Tento příkaz získá všechny psSessions , které byly vytvořeny v aktuální relaci. Nezískute psSessions , které byly vytvořeny v jiných relacích nebo v jiných počítačích, i když se k tomuto počítači připojují.

Příklad 2: Připojení relací k místnímu počítači

Get-PSSession -ComputerName "localhost"

Tento příkaz získá psSessions , které jsou připojeny k místnímu počítači. Pokud chcete označit místní počítač, zadejte název počítače, localhost nebo tečku (.).

Příkaz vrátí všechny relace na místním počítači, i když byly vytvořeny v různých relacích nebo na různých počítačích.

Příklad 3: Získání relací připojených k počítači

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

Tento příkaz získá psSessions , které jsou připojeny k počítači Server02.

Příkaz vrátí všechny relace na serveru Server02, i když byly vytvořeny v různých relacích nebo na různých počítačích.

Výstup ukazuje, že dvě relace mají Disconnected stav a Busy dostupnost. Byly vytvořeny v různých relacích a aktuálně se používají. Relace ScheduledJobs , která je Opened a Availablebyla vytvořena v aktuální relaci.

Příklad 4: Uložení výsledků tohoto příkazu

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

Tento příklad ukazuje, jak uložit výsledky Get-PSSession příkazu do více proměnných.

První příkaz pomocí rutiny New-PSSession vytvoří psSessions na třech vzdálených počítačích.

Druhý příkaz pomocí Get-PSSession rutiny získá tři psSessions. Potom uloží každou ze psSessions v samostatné proměnné.

Když PowerShell přiřadí pole objektů k matici proměnných, přiřadí první objekt k první proměnné, druhý objekt druhé proměnné atd. Pokud existuje více objektů než proměnných, přiřadí všechny zbývající objekty poslední proměnné v poli. Pokud existuje více proměnných než objekty, nepoužijí se další proměnné.

Příklad 5: Odstranění relace pomocí ID instance

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

Tento příklad ukazuje, jak získat PSSession pomocí ID instance a poté odstranit PSSession.

První příkaz získá všechny psSessions , které byly vytvořeny v aktuální relaci. Odešle psSessions do Format-Table rutiny, která zobrazí Vlastnosti ComputerName a InstanceID každé PSSession.

Druhý příkaz použije rutinu Get-PSSession k získání konkrétní psSession a k jejímu uložení do $s proměnné. Příkaz používá parametr InstanceID k identifikaci PSSession.

Třetí příkaz používá rutinu Remove-PSSession k odstranění psSession v $s proměnné.

Příklad 6: Získání relace s konkrétním názvem

Příkazy v tomto příkladu najdou relaci, která má konkrétní formát názvu, a používá konkrétní konfiguraci relace a pak se k relaci připojí. Podobný příkaz můžete použít k vyhledání relace, ve které kolega spustil úkol a připojil se k dokončení úkolu.

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

První příkaz získá relace na vzdálených počítačích Se serverem 02 a Server12, které mají názvy začínající BackupJob a používají ITTasks konfiguraci relace. Příkaz pomocí parametru Name určuje vzor názvů a parametr ConfigurationName k určení konfigurace relace. Hodnota parametru SessionOption je tabulka hash, která nastaví hodnotu OperationTimeout na 240000 milisekundy (4 minuty). Toto nastavení dává příkazu více času na dokončení. Parametry ConfigurationName a SessionOption slouží ke konfiguraci dočasných relací, ve kterých se rutina Get-PSSession spouští na každém počítači. Výstup ukazuje, že příkaz vrátí BackupJob04 relaci. Relace je odpojená a dostupnost znamenáNone, že se nepoužívá.

Druhý příkaz pomocí rutiny Get-PSSession přejde k BackupJob04 relaci a rutině Connect-PSSession se připojí k relaci. Příkaz uloží relaci do $s proměnné.

Třetí příkaz získá relaci v $s proměnné. Výstup ukazuje, že Connect-PSSession příkaz byl úspěšný. Relace je ve stavu Otevření a je k dispozici pro použití.

Příklad 7: Získání relace pomocí jeho ID

Get-PSSession -Id 2

Tento příkaz získá PSSession s ID 2. Protože hodnota vlastnosti ID je jedinečná pouze v aktuální relaci, parametr ID je platný pouze pro místní příkazy.

Parametry

-AllowRedirection

Označuje, že tato rutina umožňuje přesměrování tohoto připojení na alternativní identifikátor URI (Uniform Resource Identifier). PowerShell ve výchozím nastavení nepřesměrovává připojení.

Tento parametr nakonfiguruje dočasné připojení, které se vytvoří pro spuštění Get-PSSession příkazu s parametrem ConnectionUri .

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ApplicationName

Určuje název aplikace. Tato rutina se připojí pouze k relacím, které používají zadanou aplikaci.

Zadejte segment názvu aplikace identifikátoru URI připojení. Například v následujícím identifikátoru URI připojení je název aplikace WSMan: http://localhost:5985/WSMAN. Název aplikace relace je uložen ve vlastnosti Runspace.ConnectionInfo.AppName relace.

Hodnota tohoto parametru slouží k výběru a filtrování relací. Nemění aplikaci, kterou relace používá.

Typ:	String
Position:	Named
Default value:	All sessions
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Authentication

Určuje mechanismus, který se používá k ověření přihlašovacích údajů pro relaci, ve které se Get-PSSession příkaz spouští.

Tento parametr konfiguruje dočasné připojení, které je vytvořeno pro spuštění Get-PSSession příkazu s parametrem ComputerName nebo ConnectionUri .

Tento parametr přijímá tyto hodnoty:

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

Výchozí hodnota je Default.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.

Upozornění

Ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	AuthenticationMechanism
Přípustné hodnoty:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	Default
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k vytvoření relace, ve které se Get-PSSession příkaz spouští. Zadejte kryptografický otisk certifikátu.

Tento parametr konfiguruje dočasné připojení, které je vytvořeno pro spuštění Get-PSSession příkazu s parametrem ComputerName nebo ConnectionUri .

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte v jednotce PowerShellu Cert: příkaz nebo Get-ChildItem hoGet-Item.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ComputerName

Určuje pole názvů počítačů. Získá relace, které se připojují k zadaným počítačům. Zástupné znaky nejsou povoleny. Není k dispozici žádná výchozí hodnota.

Počínaje windows PowerShellem 3.0 jsou objekty PSSession uložené na počítačích na vzdáleném konci každého připojení. Pokud chcete získat relace na zadaných počítačích, PowerShell vytvoří dočasné připojení ke každému počítači a spustí Get-PSSession příkaz.

Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů. Chcete-li zadat místní počítač, zadejte název localhostpočítače nebo tečku (.).

Poznámka:

Tento parametr získá relace pouze z počítačů, na kterých běží Windows PowerShell 3.0 nebo novější verze PowerShellu. Starší verze neukládají relace.

Typ:	String[]
Aliasy:	Cn
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ConfigurationName

Určuje název konfigurace. Tato rutina se dostane jenom k relacím, které používají zadanou konfiguraci relace.

Zadejte název konfigurace nebo plně kvalifikovaný identifikátor URI prostředku pro konfiguraci relace. Pokud zadáte pouze název konfigurace, před tomuto identifikátoru URI schématu: http://schemas.microsoft.com/powershell Název konfigurace relace je uložen ve vlastnosti ConfigurationName relace.

Hodnota tohoto parametru slouží k výběru a filtrování relací. Nezmění konfiguraci relace, kterou relace používá.

Další informace o konfiguracích relace najdete v tématu about_Session_Configurations.

Typ:	String
Position:	Named
Default value:	All sessions
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ConnectionUri

Určuje identifikátor URI, který definuje koncový bod připojení pro dočasnou relaci, ve které se Get-PSSession příkaz spouští. Identifikátor URI musí být plně kvalifikovaný.

Tento parametr nakonfiguruje dočasné připojení, které se vytvoří pro spuštění Get-PSSession příkazu s parametrem ConnectionUri .

Formát tohoto řetězce je:

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

Výchozí hodnota je: http://localhost:5985/WSMAN.

Pokud nezadáte ConnectionUri, můžete k zadání hodnot ConnectionURI použít parametry UseSSL, ComputerName, Port a ApplicationName. Platné hodnoty pro segment přenosu identifikátoru URI jsou HTTP a HTTPS. Pokud zadáte identifikátor URI připojení s přenosovým segmentem, ale nezadáte port, relace se vytvoří s porty standardů: 80 pro HTTP a 443 HTTPS. Pokud chcete použít výchozí porty pro vzdálené komunikace PowerShellu, zadejte port 5985 pro HTTP nebo 5986 HTTPS.

Pokud cílový počítač přesměruje připojení na jiný identifikátor URI, PowerShell zabrání přesměrování, pokud v příkazu nepoužijete parametr AllowRedirection .

Tento parametr byl představen ve Windows PowerShellu 3.0.

Tento parametr získá relace pouze z počítačů, na kterých běží Windows PowerShell 3.0 nebo novější verze Windows PowerShellu. Starší verze neukládají relace.

Typ:	Uri[]
Aliasy:	URI, CU
Position:	0
Default value:	Http://localhost:5985/WSMAN
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ContainerId

Určuje pole ID kontejnerů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými kontejnery. docker ps Pomocí příkazu získáte seznam ID kontejnerů. Další informace najdete v nápovědě k příkazu docker ps .

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Credential

Určuje přihlašovací údaje uživatele. Tato rutina spustí příkaz s oprávněními zadaného uživatele. Zadejte uživatelský účet, který má oprávnění pro připojení ke vzdálenému počítači, a spusťte Get-PSSession příkaz. Ve výchozím nastavení je to aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo nebo zadejte objekt PSCredential vygenerovaný rutinou Get-Credential Domain01\User01. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Přihlašovací údaje jsou uloženy v objektu PSCredential a heslo je uloženo jako SecureString.

Poznámka:

Další informace o ochraně dat SecureString naleznete v tématu Jak zabezpečený je SecureString?.

Tento parametr nakonfiguruje dočasné připojení vytvořené ke spuštění Get-PSSession příkazu s parametrem ComputerName nebo ConnectionUri .

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	PSCredential
Position:	Named
Default value:	Current user
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Id

Určuje pole ID relací. Tato rutina získá pouze relace se zadanými ID. Zadejte jedno nebo více ID oddělených čárkami nebo pomocí operátoru rozsahu (..) zadejte rozsah ID. Parametr ID nelze použít společně s parametrem ComputerName .

ID je celé číslo, které jednoznačně identifikuje relace spravované uživatelem v aktuální relaci. Je jednodušší zapamatovat a zadat než InstanceId, ale je jedinečný pouze v rámci aktuální relace. ID relace je uloženo ve vlastnosti ID relace.

Typ:	Int32[]
Position:	0
Default value:	All sessions
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-InstanceId

Určuje pole ID instancí relací. Tato rutina získá pouze relace se zadanými ID instancí.

ID instance je identifikátor GUID, který jednoznačně identifikuje relaci na místním nebo vzdáleném počítači. ID instance je jedinečné, i když máte v PowerShellu spuštěných více relací.

ID instance relace je uloženo ve vlastnosti InstanceID relace.

Typ:	Guid[]
Position:	Named
Default value:	All sessions
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Určuje pole názvů relací. Tato rutina získá pouze relace, které mají zadané popisné názvy. Jsou povoleny zástupné znaky.

Popisný název relace je uložen ve vlastnosti Název relace.

Typ:	String[]
Position:	Named
Default value:	All sessions
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-Port

Určuje zadaný síťový port, který se používá pro dočasné připojení, ve kterém se Get-PSSession příkaz spouští. Pokud se chcete připojit ke vzdálenému počítači, musí vzdálený počítač naslouchat na portu, který připojení používá. Výchozí porty jsou 5985, což je port WinRM pro HTTP a 5986což je port WinRM pro HTTPS.

Před použitím alternativního portu musíte nakonfigurovat naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu. Pokud chcete nakonfigurovat naslouchací proces, na příkazovém řádku PowerShellu zadejte následující dva příkazy:

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

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

Tento parametr nakonfiguruje dočasné připojení vytvořené ke spuštění Get-PSSession příkazu s parametrem ComputerName nebo ConnectionUri .

Parametr Port nepoužívejte, pokud ho nepotřebujete. Port nastavený v příkazu se vztahuje na všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může zabránit spuštění příkazu na všech počítačích.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Int32
Position:	Named
Default value:	5985, 5986
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SessionOption

Určuje upřesňující možnosti relace. Zadejte objekt SessionOption, například objekt, který vytvoříte pomocí New-PSSessionOption rutiny, nebo tabulku hash, ve které jsou klíče názvy možností relace a hodnoty jsou hodnoty možností relace.

Výchozí hodnoty pro možnosti jsou určeny hodnotou $PSSessionOption proměnné předvoleb, pokud je nastavena. V opačném případě se výchozí hodnoty vytvoří pomocí možností nastavených v konfiguraci relace.

Hodnoty možností relace mají přednost před výchozími hodnotami pro relace nastavené v $PSSessionOption proměnné předvoleb a v konfiguraci relace. Nemají však přednost před maximálními hodnotami, kvótami nebo limity nastavenými v konfiguraci relace.

Popis možností relace, včetně výchozích hodnot, naleznete v tématu New-PSSessionOption. Informace o $PSSessionOption proměnné předvoleb najdete v tématu about_Preference_Variables. Další informace o konfiguracích relace najdete v tématu about_Session_Configurations.

Typ:	PSSessionOption
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-State

Určuje stav relace. Tato rutina získá pouze relace v zadaném stavu. Přijatelné hodnoty pro tento parametr jsou: All, Opened, Disconnected, Closed, a Broken. Výchozí hodnota je All.

Hodnota stavu relace je relativní vzhledem k aktuálním relacím. Relace, které nebyly vytvořeny v aktuálních relacích a nejsou připojené k aktuální relaci, mají stav Disconnected , i když jsou připojené k jiné relaci.

Stav relace je uložen ve vlastnosti State relace.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SessionFilterState
Přípustné hodnoty:	All, Opened, Disconnected, Closed, Broken
Position:	Named
Default value:	All
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ThrottleLimit

Určuje maximální počet souběžných připojení, která lze navázat pro spuštění Get-PSSession příkazu. Pokud tento parametr vynecháte nebo zadáte hodnotu 0 (nula), použije se výchozí hodnota 32. Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Int32
Position:	Named
Default value:	32
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UseSSL

Označuje, že tato rutina používá protokol SSL (Secure Sockets Layer) k navázání připojení, ve kterém se Get-PSSession příkaz spouští. Ve výchozím nastavení se ssl nepoužívá. Pokud použijete tento parametr, ale ssl není k dispozici na portu použitém pro příkaz, příkaz selže.

Tento parametr konfiguruje dočasné připojení vytvořené ke spuštění Get-PSSession příkazu s parametrem ComputerName .

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VMId

Určuje pole ID virtuálních počítačů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými virtuálními počítači. K zobrazení dostupných virtuálních počítačů použijte následující příkaz:

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

Typ:	Guid[]
Aliasy:	VMGuid
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-VMName

Určuje pole názvů virtuálních počítačů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými virtuálními počítači. K zobrazení dostupných virtuálních počítačů použijte rutinu Get-VM .

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

PSSession

Poznámky

PowerShell obsahuje následující aliasy pro Get-PSSession:

• Všechny platformy:

  • gsn

• Tato rutina získá uživatelem spravované relace PSSession objekty, jako jsou ty, které jsou vytvořeny pomocí New-PSSession, Enter-PSSessiona Invoke-Command rutiny. Nezískáte relaci spravovanou systémem, která se vytvoří při spuštění PowerShellu.

• Počínaje windows PowerShellem 3.0 jsou objekty PSSession uložené v počítači, který je na straně serveru nebo na konci připojení. Pokud chcete získat relace uložené v místním nebo vzdáleném počítači, PowerShell vytvoří dočasnou relaci se zadaným počítačem a spustí příkazy dotazu v relaci.

• Pokud chcete získat relace, které se připojují ke vzdálenému počítači, zadejte vzdálený počítač pomocí parametrů ComputerName nebo ConnectionUri . K filtrování relací, které Get-PSSession se načte, použijte parametry Name, ID, InstanceID a State . Ke konfiguraci dočasné relace, která Get-PSSession používá, použijte zbývající parametry.

• Pokud používáte parametry ComputerName nebo ConnectionUri , Get-PSSession získá pouze relace z počítačů se systémem Windows PowerShell 3.0 a novějšími verzemi PowerShellu.

• Hodnota State vlastnost PSSession je relativní k aktuální relaci. Proto hodnota Odpojeno znamená, že psSession není připojen k aktuální relaci. Neznamená ale, že psSession je odpojen od všech relací. Může se připojit k jiné relaci. Chcete-li zjistit, zda se můžete připojit nebo znovu připojit k psSession z aktuální relace, použijte vlastnost Dostupnost .

Hodnota Dostupnost none označuje, že se můžete připojit k relaci. Hodnota Zaneprázdněn označuje, že se nemůžete připojit k psSession , protože je připojen k jiné relaci.

Další informace o hodnotách State vlastnost relací naleznete v tématu RunspaceState Výčtu.

Další informace o hodnotách vlastnosti Availability relací naleznete v tématu RunspaceAvailability Výčet.

Související odkazy

• Connect-PSSession
• Disconnect-PSSession
• Receive-PSSession
• Enter-PSSession
• Exit-PSSession
• Invoke-Command
• New-PSSession
• Remove-PSSession
• about_PSSessions
• about_Remote