Get-PSSession
Získá relace PowerShellu na místních a vzdálených počítačích.
Syntax
Name (Výchozí)
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
ComputerName
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>]
ComputerInstanceId
Get-PSSession
[-ComputerName] <String[]>
-InstanceId <Guid[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUri
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUriInstanceId
Get-PSSession
[-ConnectionUri] <Uri[]>
-InstanceId <Guid[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
VMNameInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMName <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerId
Get-PSSession
-ContainerId <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-ContainerId <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMId
Get-PSSession
-VMId <Guid[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMId <Guid[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMName
Get-PSSession
-VMName <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
InstanceId
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Id
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
Description
Rutina Get-PSSession získá relace PowerShellu spravované uživatelem (PSSessions) 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í. Pomocí parametrů ComputerName nebo ConnectionUriGet-PSSession získat relace, 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 vrácených relací Get-PSSession .
Zbývající parametry použijte ke konfiguraci dočasného připojení, ve kterém se spustí příkaz Get-PSSession při použití parametrů ComputerName nebo ConnectionUri.
Poznámka:
V prostředí Windows PowerShell 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ískáte 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řipojené k místnímu počítači. Chcete-li 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 dostupnost Busy.
Byly vytvořeny v různých relacích a aktuálně se používají. Relace ScheduledJobs, která je Opened a Available, byla 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 příkazu Get-PSSession do více proměnných.
První příkaz používá rutinu New-PSSession k vytvoření psSessions na třech vzdálených počítačích.
Druhý příkaz používá rutinu Get-PSSession k získání tří psSessions. Potom uloží každou psSessions do 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 pak odstranit PSSession.
První příkaz získá všechny psSessions, které byly vytvořeny v aktuální relaci. Odešle psSessions do rutiny Format-Table , která zobrazí vlastnosti ComputerName a InstanceID každé PSSession.
Druhý příkaz pomocí rutiny Get-PSSession získá konkrétní PSSession a uloží ji do proměnné $s. Příkaz používá parametr
Třetí příkaz používá rutinu Remove-PSSession k odstranění PSSession v proměnné $s.
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í konfiguraci relace ITTasks. Příkaz pomocí parametru Name určuje vzor názvů a parametr ConfigurationName k určení konfigurace relace. Hodnota parametru SessionOption je tabulka hodnot hash, která nastavuje hodnotu OperationTimeout na 240000 milisekund (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 je None, což znamená, že se nepoužívá.
Druhý příkaz používá rutinu Get-PSSession k připojení k relaci BackupJob04 a rutinu Connect-PSSession pro připojení k relaci. Příkaz uloží relaci do proměnné $s.
Třetí příkaz získá relaci v proměnné $s. Výstup ukazuje, že příkaz Connect-PSSession 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. Vzhledem k tomu, že hodnota vlastnosti ID je jedinečná pouze v aktuální relaci, je parametr id 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í vytvořené tak, aby spustilo příkaz Get-PSSession s parametrem ConnectionUri.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 jako URI pro 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 v Runspace.ConnectionInfo.AppName vlastnost relace.
Hodnota tohoto parametru slouží k výběru a filtrování relací. Nemění aplikaci, kterou relace používá.
Vlastnosti parametru
| Typ: | String |
| Default value: | All sessions |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Authentication
Určuje mechanismus, který se používá k ověření přihlašovacích údajů pro relaci, ve které se spouští příkaz Get-PSSession.
Tento parametr nakonfiguruje dočasné připojení vytvořené tak, aby spustilo příkaz Get-PSSession pomocí parametru ComputerName nebo ConnectionUri.
Přijatelné hodnoty pro tento parametr jsou:
DefaultBasicCredSSPDigestKerberosNegotiate-
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 pro ověření, je navrženo pro příkazy, které vyžadují ověření u více než jednoho prostředku, jako například přístup k síťové sdílené složce na dálku. 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.
Vlastnosti parametru
| Typ: | AuthenticationMechanism |
| Default value: | Default |
| Přípustné hodnoty: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 spustí příkaz Get-PSSession. Zadejte kryptografický otisk certifikátu.
Tento parametr nakonfiguruje dočasné připojení vytvořené tak, aby spustilo příkaz Get-PSSession pomocí parametru 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 příkaz Get-Item nebo Get-ChildItem na jednotce PowerShellu Cert:.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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. Neexistuje žádná výchozí hodnota.
Počínaje windows PowerShellem 3.0 jsou objekty PSSession uloženy 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í k jednotlivým počítačům a spustí příkaz Get-PSSession.
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 počítače, localhostnebo 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Kn |
Sady parametrů
ComputerInstanceId
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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ě kvalifikovanou URI prostředku pro konfiguraci relace. Pokud zadáte pouze název konfigurace, předzálohuje se následující identifikátor URI schématu: http://schemas.microsoft.com/powershell. Název konfigurace relace je uložen v ConfigurationName vlastnosti 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 relací naleznete v části about_Session_Configurations.
Vlastnosti parametru
| Typ: | String |
| Default value: | All sessions |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ContainerId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ContainerIdInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMIdInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMNameInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ConnectionUri
Určuje identifikátor URI, který definuje koncový bod připojení pro dočasnou relaci, ve které se spustí příkaz Get-PSSession. Identifikátor URI musí být plně kvalifikovaný.
Tento parametr nakonfiguruje dočasné připojení vytvořené tak, aby spustilo příkaz Get-PSSession 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 použít parametry UseSSL, Názevpočítače, Porta ApplicationName zadat hodnoty ConnectionURI. 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 5985 portu pro PROTOKOL HTTP nebo 5986 pro 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.
Vlastnosti parametru
| Typ: | Uri[] |
| Default value: | Http://localhost:5985/WSMAN |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | identifikátor URI, CU |
Sady parametrů
ConnectionUriInstanceId
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ContainerId
Určuje pole ID kontejnerů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými kontejnery. Pomocí příkazu docker ps získejte seznam ID kontejnerů. Další informace najdete v nápovědě k příkazu docker ps.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ContainerId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ContainerIdInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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 s oprávněním připojit se ke vzdálenému počítači a spusťte příkaz Get-PSSession. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinou Get-Credential. 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 najdete v tématu Jak zabezpečený je SecureString?.
Tento parametr nakonfiguruje dočasné připojení vytvořené ke spuštění příkazu Get-PSSession s parametrem ComputerName nebo ConnectionUri.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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šší pamatovat a psát než InstanceId, ale je jedinečný pouze v rámci aktuální relace. ID relace je uloženo ve vlastnosti ID relace.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | All sessions |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Id
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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 v InstanceID vlastnost relace.
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | All sessions |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ContainerIdInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMIdInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMNameInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
InstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 v Název vlastnost relace.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | All sessions |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Name
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ContainerId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Port
Určuje zadaný síťový port, který se používá pro dočasné připojení, ve kterém se spouští příkaz Get-PSSession. 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 5986, což 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í příkazu Get-PSSession s parametrem ComputerName nebo ConnectionUri.
Nepoužívejte parametr Port, pokud není nutné. Port nastavený v příkazu platí pro 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.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | 5985, 5986 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SessionOption
Určuje pokročilé možnosti relace. Zadejte objekt SessionOption, například objekt, který vytvoříte pomocí příkazu New-PSSessionOption, nebo tabulku hash, kde 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 proměnné předvoleb $PSSessionOption, 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 relace nastavenými v proměnné předvoleb $PSSessionOption 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, najdete v tématu New-PSSessionOption.
Informace o proměnné předvoleb $PSSessionOption naleznete v tématu about_Preference_Variables. Další informace o konfiguracích relací naleznete v části about_Session_Configurations.
Vlastnosti parametru
| Typ: | PSSessionOption |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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, Closeda 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řipojeny k jiné relaci.
Stav relace je uložen v State vlastnost relace.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SessionFilterState |
| Default value: | All |
| Přípustné hodnoty: | All, Opened, Disconnected, Closed, Broken |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ContainerId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ContainerIdInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMIdInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
VMNameInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ThrottleLimit
Určuje maximální počet souběžných připojení, která lze navázat pro spuštění příkazu Get-PSSession. 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.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | 32 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUriInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ConnectionUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UseSSL
Označuje, že tato rutina používá protokol SSL (Secure Sockets Layer) k navázání připojení, ve kterém se spouští příkaz Get-PSSession. 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 nakonfiguruje dočasné připojení vytvořené tak, aby spustilo příkaz Get-PSSession s parametrem ComputerName.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerInstanceId
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | VMGuid |
Sady parametrů
VMId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMIdInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
VMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMNameInstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Do tohoto cmdletu nemůžete předávat objekty.
Výstupy
PSSession
Poznámky
PowerShell obsahuje následující aliasy pro Get-PSSession:
Všechny platformy:
gsn
Tato rutina získá relace spravované uživatelem objekty PSSession objekty, jako jsou ty, které jsou vytvořeny pomocí rutin
New-PSSession,Enter-PSSessionaInvoke-Command. 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ženy 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í
ComputerName nebo ConnectionUri parametry. Chcete-li filtrovat relace, kteréGet-PSSessionse dostanou, použijte parametry Name, ID, InstanceID a State . Pomocí zbývajících parametrů nakonfigurujte dočasnou relaci, kteráGet-PSSessionpoužívá.Pokud použijete parametry ComputerName nebo ConnectionUri,
Get-PSSessionzíská jenom relace z počítačů se systémem Windows PowerShell 3.0 a novějšími verzemi PowerShellu.Hodnota vlastnosti StatePSSes sion je relativní vzhledem k aktuální relaci. Proto hodnota Odpojeno znamená, že psSession není připojen k aktuální relaci. Neznamená však, že PSSession je odpojen od všech relací. Může být připojeno 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 Availability.
Hodnota dostupnost
Další informace o hodnotách State vlastnost relace naleznete v tématu RunspaceState Výčtu.
Další informace o hodnotách vlastnosti Availability relací naleznete v tématu Výčtu RunspaceAvailability.