Get-PSSession
在本地和遠端電腦上取得 PowerShell 會話。
語法
Name (預設值)
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
該 Get-PSSession 指令小程式接收本地及遠端電腦上由使用者管理的 PowerShell 會話（PSSessions）。
從 Windows PowerShell 3.0 開始，會話會儲存在每個連線遠端端的電腦上。 你可以使用 ComputerName 或 Get-PSSession 參數來取得連接到本地電腦或遠端電腦的會話，即使它們不是在當前會話中建立的。
沒有參數時， Get-PSSession 會取得目前會話中建立的所有會話。
使用篩選參數，包括 Name、 Id、 InstanceId、 State、 ApplicationName 和 ConfigurationName ，從回 Get-PSSession 傳的會話中選擇。
使用剩餘參數來設定指令執行的暫時連線 Get-PSSession ，當你使用 ComputerName 或 ConnectionUri 參數時。
Note
在 PowerShell 2.0 Windows 中，沒有參數的話，Get-PSSession 會取得目前會話中建立的所有會話。
ComputerName 參數取得在當前工作階段建立並連接到指定電腦的會話。
如需 PowerShell 工作階段的詳細資訊，請參閱 about_PSSessions。
範例
範例 1：在當前會話中建立會話
Get-PSSession
這個指令會取得本場次所建立的所有 PSSessions 。 即使連線到該電腦，也不會接收在其他工作階段或電腦上建立的 PSSessions 。
範例 2：讓會話連接到本地電腦
Get-PSSession -ComputerName "localhost"
此指令取得連接至本地電腦的 PSSessions 。 要標示本地電腦，請輸入電腦名稱、localhost 或點（.）
這個指令會回傳本地電腦上的所有會話，即使它們是在不同的會話或不同電腦上建立的。
範例 3：讓會話連接到電腦
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
此指令會取得連接到 Server02 電腦的 PSSessions 。
這個指令會回傳 Server02 上的所有會話，即使它們是在不同的會話或不同電腦上建立的。
輸出顯示兩個會話有 Disconnected 狀態和可用性 Busy 。
它們是在不同的會議階段建立的，目前仍在使用中。 該 ScheduledJobs 會話（即 和 OpenedAvailable）是在當前會話中建立的。
範例 4：儲存此指令的結果
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession
這個範例展示了如何將指令結果 Get-PSSession 儲存在多個變數中。
第一個指令使用 New-PSSession 指令小程式在三台遠端電腦上建立 PSSessions 。
第二個指令使用 Get-PSSession 指令檔來取得三個 PSSession。 接著會將每個 PSSession 分別儲存在不同的變數中。
當 PowerShell 將物件陣列指派給變數陣列時，它會將第一個物件指派給第一個變數，第二個物件指派給第二個變數，依此類推。 如果物件數多於變數，則會將所有剩餘物件分配到陣列中最後一個變數。 若變數多於物件，則不使用多餘變數。
範例 5：使用實例 ID 刪除會話
Get-PSSession | Format-Table -Property ComputerName, InstanceId
$s = Get-PSSession -InstanceId a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s
這個範例展示了如何利用 PSSession 的實例 ID 取得該 PSSession，然後刪除該 PSSession。
第一個指令會取得本場次中建立的所有 PSSessions 。 它會將 PSSessions 傳送給 Format-Table cmdlet，該 cmdlet 會顯示每個 PSSession 的 ComputerName 和 InstanceId 屬性。
第二個指令使用 Get-PSSession cmdlet 取得特定的 PSSession 並儲存在變數中 $s 。 指令使用 InstanceId 參數來識別 PSSession。
第三個指令使用 Remove-PSSession cmdlet 來刪除變數中的 $s。
範例 6：取得一個有特定名稱的會話
此範例中的指令會找到具有特定名稱格式且使用特定會話設定的會話，然後連接到該會話。 你可以用類似的指令找到同事開始任務的會話，並連線完成任務。
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
第一個指令會取得 Server02 和 Server12 遠端電腦上的會話，這些電腦名稱以 session BackupJob 開頭，並使用會 ITTasks 話設定。此指令使用 Name 參數來指定名稱模式，並使用 ConfigurationName 參數來指定會話設定。
SessionOption 參數的值是一個雜湊表，將操作逾時值設定為240000毫秒（4 分鐘）。 此設定讓指令有更多時間完成。ConfigurationName 與 SessionOption 參數用於配置 cmdlet 在Get-PSSession每台電腦上執行的臨時會話。輸出顯示指令回傳會話。BackupJob04 會話已斷線， 可用性為None，表示未被使用。
第二個指令使用 cmdlet 來進入Get-PSSession會話，並BackupJob04用 Connect-PSSession cmdlet 連接會話。 指令會將工作階段儲存在變數中 $s 。
第三個指令會取得變數中的 $s 會話。 輸出顯示 Connect-PSSession 指令成功。 該會話處於 開啟 狀態，並可供使用。
範例 7：利用 ID 取得會話
Get-PSSession -Id 2
此指令會獲得帶有 ID 的 2 。 由於 Id 屬性的值僅在當前會話中唯一，因此 Id 參數僅適用於本地指令。
參數
-AllowRedirection
指出此 Cmdlet 允許將此連線重新導向至替代的統一資源識別碼 （URI）。 預設情況下，PowerShell 不會重新導向連線。
此參數用來設定所建立的暫存連線，以執行 Get-PSSession 帶有 ConnectionUri 參數的指令。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ApplicationName
指定應用程式名稱。 此指令只連接使用指定應用程式的會話。
輸入連接 URI 的應用程式名稱區段。 例如，在以下連線 URI 中，應用程式名稱為 WSMan： http://localhost:5985/WSMAN。 會話的應用程式名稱會儲存在該會話的 Runspace.ConnectionInfo.AppName 屬性中。
此參數的值用於選擇與篩選會話。 它不會改變該會話所使用的應用程式。
參數屬性
| 類型: | String |
| 預設值: | All sessions |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Authentication
指定用於驗證指令執行會話 Get-PSSession 憑證的機制。
此參數用來設定建立的臨時連線，以執行 Get-PSSession 帶有 ComputerName 或 ConnectionUri 參數的指令。
此參數可接受的值為：
DefaultBasicCredSSPDigestKerberosNegotiate-
NegotiateWithImplicitCredential。
預設值為 Default。
如需此參數值的詳細資訊，請參閱 AuthenticationMechanism 列舉。
Caution
認證安全性支援提供者（CredSSP）驗證的設計目的是將使用者的認證傳遞給遠端電腦進行認證，適用於需要在多個資源上進行驗證的命令，例如存取遠端網路共用。 此機制會增加遠端作業的安全性風險。 如果遠端電腦遭到入侵，傳遞給它的認證可用來控制網路會話。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | AuthenticationMechanism |
| 預設值: | Default |
| 接受的值: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificateThumbprint
指定有權建立執行該 Get-PSSession 指令會話的使用者帳號的數位公鑰憑證（X509）。 輸入憑證的指紋。
此參數用來設定建立的臨時連線，以執行 Get-PSSession 帶有 ComputerName 或 ConnectionUri 參數的指令。
憑證用於客戶端憑證型驗證。 它們只能對應至本機用戶帳戶;它們不適用於網域帳戶。
要取得憑證的指紋，請在 PowerShell Get-Item 磁碟機中使用 a Get-ChildItem 或 Cert: 指令。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ComputerName
指定計算機名稱的陣列。 取得連接到指定電腦的會話。 不允許使用萬用字元。 沒有預設值。
從 PowerShell 3.0 Windows 開始，PSSession 物件會儲存在每個連線遠端的電腦端。 為了在指定的電腦上取得會話，PowerShell 會建立一個暫時連線到每台電腦並執行 Get-PSSession 指令。
輸入 NetBIOS 名稱、IP 位址，或一台或多台電腦的完整限定網域名稱。 若要指定本機計算機，請輸入計算機名稱、localhost或點 （.）。
Note
此參數僅接收執行 Windows PowerShell 3.0 或更新版本 PowerShell 的電腦的會話。 早期版本不儲存會話。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | Cn |
參數集
ComputerInstanceId
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ConfigurationName
指定配置名稱。 此指令只存取使用指定會話設定的會話。
輸入工作階段組態的組態名稱或完整限定資源URI。 如果您只指定組態名稱，則前面會加上下列架構 URI：http://schemas.microsoft.com/powershell。 會話的組態名稱會儲存在會話的 ConfigurationName 屬性中。
此參數的值用於選擇與篩選會話。 它不會改變該會話所使用的會話設定。
如需工作階段組態的詳細資訊，請參閱 about_Session_Configurations。
參數屬性
| 類型: | String |
| 預設值: | All sessions |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ContainerId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ContainerIdInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMIdInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMNameInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ConnectionUri
指定一個 URI，定義該指令執行的臨時會話 Get-PSSession 的連線端點。 URI 必須完整限定。
此參數用來設定所建立的暫存連線，以執行 Get-PSSession 帶有 ConnectionUri 參數的指令。
此字串的格式為：
<Transport>://<ComputerName>:<Port\>/<ApplicationName>
預設值為 http://localhost:5985/WSMAN。
如果你沒有指定 ConnectionUri，可以使用 UseSSL、ComputerName、Port 和 ApplicationName 參數來指定 ConnectionURI 的值。 URI 傳輸區段的有效值為 HTTP 和 HTTPS。 如果您指定具有傳輸區段的連線 URI，但未指定埠，則會使用標準埠建立會話：80 HTTP 和 HTTPS 的 443。 若要使用 PowerShell 遠端處理的預設埠，請針對 HTTP 指定埠 5985 或針對 HTTPS 指定 5986。
如果目的地計算機將連線重新導向至不同的 URI，除非您在命令中使用 AllowRedirection 參數，否則 PowerShell 會防止重新導向。
此參數是在 Windows PowerShell 3.0 中引進的。
此參數僅能從執行 Windows PowerShell 3.0 或更新版本的 Windows PowerShell 電腦取得會話。 早期版本不儲存會話。
參數屬性
| 類型: | Uri[] |
| 預設值: | Http://localhost:5985/WSMAN |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | URI, CU |
參數集
ConnectionUriInstanceId
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ContainerId
指定包含容器 ID 的陣列。 此 Cmdlet 會啟動具有每個指定容器的互動式會話。 使用 docker ps 命令來取得容器標識碼的清單。 如需詳細資訊，請參閱 docker ps 命令的說明。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ContainerId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ContainerIdInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Credential
指定使用者憑證。 此 cmdlet 以指定使用者的權限執行指令。 指定一個有權限連接到遠端電腦的使用者帳號並執行指令 Get-PSSession 。 預設值為目前的使用者。
輸入用戶名稱，例如 User01 或 Domain01\User01，或輸入 Cmdlet 所產生的 Get-Credential 物件。 如果您輸入使用者名稱，系統會提示您輸入密碼。
認證會儲存在 PSCredential 物件中，密碼會儲存為 secureString 。
Note
如需 SecureString 數據保護的詳細資訊，請參閱 SecureString 有多安全？。
此參數配置為用 Get-PSSession 或 ConnectionUri 參數執行指令所建立的臨時連線。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | PSCredential |
| 預設值: | Current user |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定一組會話 ID 陣列。 此指令只接收指定 ID 的會話。 輸入一個或多個 ID，並以逗號分隔，或使用範圍運算子（..）來指定 ID 範圍。
你不能同時使用 Id 參數和 ComputerName 參數。
ID 是一個整數，唯一識別目前會話中使用者管理的會話。 它比 InstanceID 更容易記憶和輸入，但它只在當前會話中唯一。 會話的 ID 會儲存在該會話的 Id 屬性中。
參數屬性
| 類型: | Int32[] |
| 預設值: | All sessions |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Id
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InstanceId
指定會話的實例 ID 陣列。 此 cmdlet 只會接收指定實例 ID 的會話。
實例 ID 是一個 GUID，唯一識別本地或遠端電腦上的會話。 InstanceID 是唯一的，即使你在 PowerShell 裡有多個工作階段。
會話的實例 ID 會儲存在該會話的 InstanceId 屬性中。
參數屬性
| 類型: | Guid[] |
| 預設值: | All sessions |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ContainerIdInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMIdInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMNameInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
InstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定一組會話名稱陣列。 此指令只接收具有指定友善名稱的會話。 允許使用通配符字元。
會話的友方名稱會儲存在該會話的 Name 屬性中。
參數屬性
| 類型: | String[] |
| 預設值: | All sessions |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
Name
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ContainerId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Port
指定用於指令執行的臨時連線 Get-PSSession 所使用的特定網路埠。 若要連線到遠端電腦，遠端計算機必須接聽連線所使用的埠。 默認埠為 5985，這是 HTTP 的 WinRM 連接埠，而 5986，這是 HTTPS 的 WinRM 連接埠。
使用替代埠之前，您必須在遠端電腦上設定 WinRM 接聽程式，以在該埠接聽。 若要設定接聽程式，請在PowerShell提示字元中輸入下列兩個命令：
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
此參數配置為用 Get-PSSession 或 ConnectionUri 參數執行指令所建立的臨時連線。
除非您必須，否則請勿使用 Port 參數。 指令中的 埠 設定適用於所有執行該指令的電腦或會話。 替代埠設定可能會防止命令在所有計算機上執行。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | Int32 |
| 預設值: | 5985, 5986 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SessionOption
指定工作階段的進階選項。 輸入 SessionOption 物件，例如您使用 New-PSSessionOption Cmdlet 建立的物件，或是鍵為工作階段選項名稱、值為工作階段選項值的哈希表。
如果設定選項，選項的預設值取決於 $PSSessionOption 喜好設定變數的值。 否則，預設值是由會話組態中設定的選項所建立。
會話選項值優先於 $PSSessionOption 喜好設定變數和會話組態中設定的會話預設值。 不過，它們不會優先於會話設定中設定的最大值、配額或限制。
如需工作階段選項的描述，包括預設值，請參閱 New-PSSessionOption。
如需 $PSSessionOption 喜好設定變數的相關信息，請參閱 about_Preference_Variables。 如需工作階段組態的詳細資訊，請參閱 about_Session_Configurations。
參數屬性
| 類型: | PSSessionOption |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-State
指定會話狀態。 此指令小程式僅能接收指定狀態下的會話。 此參數的可接受值為：All、 OpenedDisconnectedClosedBroken和 。 預設值為 All。
會話狀態值是相對於目前會話的值。 未在當前會話建立且未連接於當前會話的會話，即使連接到不同的會話，仍會顯示狀態為 。Disconnected
會話的狀態會儲存在該會話的 狀態 屬性中。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SessionFilterState |
| 預設值: | All |
| 接受的值: | All, Opened, Disconnected, Closed, Broken |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ContainerId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ContainerIdInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMIdInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
VMNameInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ThrottleLimit
指定可建立的最大並行連線數量以執行該 Get-PSSession 指令。 如果您省略此參數或輸入 0 值 （零），則會使用預設值 32。 節流限制僅適用於目前的命令，不適用於會話或計算機。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | Int32 |
| 預設值: | 32 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUriInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ConnectionUri
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseSSL
表示此指令小程式使用安全套接層（SSL）協定來建立指令執行的 Get-PSSession 連線。 根據預設，不會使用 SSL。 如果你使用這個參數，但該指令所用的埠口沒有 SSL，該指令就會失敗。
此參數用來設定建立的臨時連線，以執行 Get-PSSession 帶有 ComputerName 參數的指令。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerInstanceId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-VMId
指定虛擬機的 ID 陣列。 此指令本會啟動與每個指定虛擬機的互動式會話。 要查看可用的虛擬機器，請使用以下指令：
Get-VM | Select-Object -Property Name, ID
參數屬性
| 類型: | Guid[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | VMGuid |
參數集
VMId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMIdInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-VMName
指定包含虛擬機器名稱的陣列。 此指令本會啟動與每個指定虛擬機的互動式會話。 要查看可用的虛擬機器，請使用 Get-VM cmdlet。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
VMName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
VMNameInstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
None
您不能將物件透過管道傳送到此 Cmdlet。
輸出
PSSession
備註
PowerShell 包含下列 Get-PSSession的別名：
所有平臺：
gsn
此指令小程式可取得使用者管理的會話 PSSession 物件，例如使用
New-PSSession、Enter-PSSession和Invoke-Command指令碼（cmdlet）所建立的物件。 它不會取得啟動 PowerShell 時建立的系統管理會話。從 PowerShell 3.0 Windows開始，PSSession物件會儲存在連線的伺服器端或接收端的電腦上。 為了取得儲存在本地電腦或遠端電腦上的會話，PowerShell 會建立一個暫存會話到指定的電腦，並在會話中執行查詢指令。
要取得連接到遠端電腦的會話，請使用 ComputerName 或 ConnectionUri 參數指定遠端電腦。 要篩選接收的
Get-PSSession會話，請使用 名稱（Name）、 識別（ID）、 實例ID（InstanceId）和 狀態（State ）參數。 利用剩餘參數來設定使用Get-PSSession該使用的臨時會話。當你使用 ComputerName 或 ConnectionUri參數時，
Get-PSSession只會接收來自執行 PowerShell 3.0 及更新版本電腦Windows會話。PSSession 的狀態屬性價值相對於當前會話而言。 因此，值 為「斷線 」表示 PSSession 與當前會話不相關。 然而，這並不代表 PSSession 與所有會議都斷開。 它可能會連線到不同的工作階段。 要判斷你是否能從目前會話連接或重新連接 PSSession ，請使用 Availability 屬性。
Availability 值 None 表示您可以連線到會話。 「 忙碌 」的值表示你無法連接到 PSSession ，因為它已經連接到另一個會話。
欲了解更多關於會話 狀態 屬性值的資訊，請參閱 RunspaceState Enumeration。
欲了解更多關於會話 可用性屬性值 的資訊，請參閱 RunspaceAvailability 列舉。
