Bagikan melalui

Get-PSSession

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mendapatkan sesi PowerShell di komputer lokal dan jarak jauh.

Sintaks

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>]

Deskripsi

Cmdlet Get-PSSession mendapatkan sesi PowerShell yang dikelola pengguna (PSSessions) di komputer lokal dan jarak jauh.

Dimulai di Windows PowerShell 3.0, sesi disimpan di komputer di akhir jarak jauh setiap koneksi. Anda dapat menggunakan parameter ComputerName atau ConnectionUriGet-PSSession untuk mendapatkan sesi yang tersambung ke komputer lokal atau komputer jarak jauh, meskipun tidak dibuat dalam sesi saat ini.

Tanpa parameter, Get-PSSession mendapatkan semua sesi yang dibuat dalam sesi saat ini.

Gunakan parameter pemfilteran, termasuk Nama, id , InstanceId , State, ApplicationName, dan ConfigurationName untuk dipilih dari antara sesi yang Get-PSSession kembalikan.

Gunakan parameter yang tersisa untuk mengonfigurasi koneksi sementara tempat perintah Get-PSSession berjalan saat Anda menggunakan parameter ComputerName atau ConnectionUri.

Nota

Di Windows PowerShell 2.0, tanpa parameter, Get-PSSession mendapatkan semua sesi yang dibuat dalam sesi saat ini. Parameter ComputerName mendapatkan sesi yang dibuat dalam sesi saat ini dan menyambungkan ke komputer yang ditentukan.

Untuk informasi selengkapnya tentang sesi PowerShell, lihat about_PSSessions.

Contoh

Contoh 1: Mendapatkan sesi yang dibuat dalam sesi saat ini

Get-PSSession

Perintah ini mendapatkan semua PSSessions yang dibuat dalam sesi saat ini. Ini tidak mendapatkan PSSessions yang dibuat di sesi lain atau di komputer lain, bahkan jika mereka tersambung ke komputer ini.

Contoh 2: Mendapatkan sesi yang tersambung ke komputer lokal

Get-PSSession -ComputerName "localhost"

Perintah ini mendapatkan PSSessions yang tersambung ke komputer lokal. Untuk menunjukkan komputer lokal, ketik nama komputer, localhost, atau titik (.)

Perintah mengembalikan semua sesi di komputer lokal, bahkan jika dibuat dalam sesi yang berbeda atau di komputer yang berbeda.

Contoh 3: Mendapatkan sesi yang tersambung ke komputer

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

Perintah ini mendapatkan PSSessions yang tersambung ke komputer Server02.

Perintah mengembalikan semua sesi di Server02, bahkan jika dibuat dalam sesi yang berbeda atau di komputer yang berbeda.

Output menunjukkan bahwa dua sesi memiliki status Disconnected dan ketersediaan Busy. Mereka dibuat dalam sesi yang berbeda dan saat ini sedang digunakan. Sesi ScheduledJobs, yang Opened dan Available, dibuat dalam sesi saat ini.

Contoh 4: Simpan hasil perintah ini

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

Contoh ini menunjukkan cara menyimpan hasil perintah Get-PSSession dalam beberapa variabel.

Perintah pertama menggunakan cmdlet New-PSSession untuk membuat PSSessions pada tiga komputer jarak jauh.

Perintah kedua menggunakan cmdlet Get-PSSession untuk mendapatkan tiga PSSessions. Kemudian menyimpan masing-masing PSSessions dalam variabel terpisah.

Saat PowerShell menetapkan array objek ke array variabel, PowerShell menetapkan objek pertama ke variabel pertama, objek kedua ke variabel kedua, dan sebagainya. Jika ada lebih banyak objek daripada variabel, objek tersebut menetapkan semua objek yang tersisa ke variabel terakhir dalam array. Jika ada lebih banyak variabel daripada objek, variabel tambahan tidak digunakan.

Contoh 5: Menghapus sesi dengan menggunakan ID instans

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

Contoh ini menunjukkan cara mendapatkan PSSession dengan menggunakan ID instansnya, lalu menghapus PSSession.

Perintah pertama mendapatkan semua PSSessions yang dibuat dalam sesi saat ini. Ini mengirimkan PSSessions ke cmdlet Format-Table, yang menampilkan properti ComputerName dan InstanceId dari setiap PSSession .

Perintah kedua menggunakan cmdlet Get-PSSession untuk mendapatkan PSSession tertentu dan untuk menyimpannya dalam variabel $s. Perintah ini menggunakan parameter InstanceId untuk mengidentifikasi PSSession.

Perintah ketiga menggunakan cmdlet Remove-PSSession untuk menghapus PSSession dalam variabel $s.

Contoh 6: Mendapatkan sesi yang memiliki nama tertentu

Perintah dalam contoh ini menemukan sesi yang memiliki format nama tertentu dan menggunakan konfigurasi sesi tertentu lalu menyambungkan ke sesi. Anda dapat menggunakan perintah seperti ini untuk menemukan sesi di mana kolega memulai tugas dan menyambungkan untuk menyelesaikan tugas.

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

Perintah pertama mendapatkan sesi di komputer jarak jauh Server02 dan Server12 yang memiliki nama yang dimulai dengan BackupJob dan menggunakan konfigurasi sesi ITTasks. Perintah menggunakan parameter Nama untuk menentukan pola nama dan parameter ConfigurationName untuk menentukan konfigurasi sesi. Nilai parameter SessionOption adalah tabel hash yang menetapkan nilai OperationTimeout ke milidetik 240000 (4 menit). Pengaturan ini memberi perintah lebih banyak waktu untuk menyelesaikannya. Parameter ConfigurationName dan SessionOption digunakan untuk mengonfigurasi sesi sementara tempat cmdlet Get-PSSession berjalan di setiap komputer. Output menunjukkan bahwa perintah mengembalikan sesi BackupJob04. Sesi terputus dan KetersediaanNone, yang menunjukkan bahwa sesi tersebut tidak digunakan.

Perintah kedua menggunakan cmdlet Get-PSSession untuk masuk ke sesi BackupJob04 dan cmdlet Connect-PSSession untuk terhubung ke sesi. Perintah menyimpan sesi dalam variabel $s.

Perintah ketiga mendapatkan sesi dalam variabel $s. Output menunjukkan bahwa perintah Connect-PSSession berhasil. Sesi berada dalam status Dibuka dan tersedia untuk digunakan.

Contoh 7: Mendapatkan sesi dengan menggunakan ID-nya

Get-PSSession -Id 2

Perintah ini mendapatkan PSSession dengan ID 2. Karena nilai properti Id hanya unik dalam sesi saat ini, parameter Id hanya berlaku untuk perintah lokal.

Parameter

-AllowRedirection

Menunjukkan bahwa cmdlet ini memungkinkan pengalihan koneksi ini ke Pengidentifikasi Sumber Daya Seragam (URI) alternatif. Secara default, PowerShell tidak mengalihkan koneksi.

Parameter ini mengonfigurasi koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ConnectionUri.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ApplicationName

Menentukan nama aplikasi. Cmdlet ini hanya terhubung ke sesi yang menggunakan aplikasi yang ditentukan.

Masukkan segmen nama aplikasi dari URI koneksi. Misalnya, dalam URI koneksi berikut, nama aplikasinya adalah WSMan: http://localhost:5985/WSMAN. Nama aplikasi sesi disimpan di properti Runspace.ConnectionInfo.AppName sesi.

Nilai parameter ini digunakan untuk memilih dan memfilter sesi. Ini tidak mengubah aplikasi yang digunakan sesi.

Jenis:String
Position:Named
Nilai default:All sessions
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Authentication

Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial untuk sesi tempat perintah Get-PSSession berjalan.

Parameter ini mengonfigurasi koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ComputerName atau ConnectionUri.

Nilai yang dapat diterima untuk parameter ini adalah:

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

Nilai defaultnya adalah Default.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism Enumeration.

Hati

Autentikasi Penyedia Dukungan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:AuthenticationMechanism
Nilai yang diterima:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Nilai default:Default
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CertificateThumbprint

Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk membuat sesi tempat perintah Get-PSSession berjalan. Masukkan thumbprint sertifikat sertifikat.

Parameter ini mengonfigurasi koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ComputerName atau ConnectionUri.

Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal; mereka tidak bekerja dengan akun domain.

Untuk mendapatkan thumbprint sertifikat, gunakan perintah Get-Item atau Get-ChildItem di drive Cert: PowerShell.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ComputerName

Menentukan array nama komputer. Mendapatkan sesi yang tersambung ke komputer yang ditentukan. Karakter kartubebas tidak diizinkan. Tidak ada nilai default.

Dimulai di Windows PowerShell 3.0, objek PSSession disimpan di komputer di akhir jarak jauh setiap koneksi. Untuk mendapatkan sesi pada komputer yang ditentukan, PowerShell membuat koneksi sementara ke setiap komputer dan menjalankan perintah Get-PSSession.

Ketik nama NetBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat dari satu atau beberapa komputer. Untuk menentukan komputer lokal, ketik nama komputer, localhost, atau titik (.).

Nota

Parameter ini hanya mendapatkan sesi dari komputer yang menjalankan Windows PowerShell 3.0 atau versi PowerShell yang lebih baru. Versi sebelumnya tidak menyimpan sesi.

Jenis:String[]
Alias:Cn
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ConfigurationName

Menentukan nama konfigurasi. Cmdlet ini hanya mendapatkan sesi yang menggunakan konfigurasi sesi yang ditentukan.

Masukkan nama konfigurasi atau URI sumber daya yang sepenuhnya memenuhi syarat untuk konfigurasi sesi. Jika Anda hanya menentukan nama konfigurasi, URI skema berikut akan ditambahkan sebelumnya: http://schemas.microsoft.com/powershell. Nama konfigurasi sesi disimpan di properti ConfigurationName sesi.

Nilai parameter ini digunakan untuk memilih dan memfilter sesi. Ini tidak mengubah konfigurasi sesi yang digunakan sesi.

Untuk informasi selengkapnya tentang konfigurasi sesi, lihat about_Session_Configurations.

Jenis:String
Position:Named
Nilai default:All sessions
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ConnectionUri

Menentukan URI yang menentukan titik akhir koneksi untuk sesi sementara tempat perintah Get-PSSession berjalan. URI harus sepenuhnya memenuhi syarat.

Parameter ini mengonfigurasi koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ConnectionUri.

Format string ini adalah:

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

Nilai defaultnya adalah: http://localhost:5985/WSMAN.

Jika Anda tidak menentukan ConnectionUri , Anda dapat menggunakan parameter UseSSL , ComputerName, Port, dan parameter ApplicationName untuk menentukan nilai ConnectionURI. Nilai yang valid untuk segmen Transportasi URI adalah HTTP dan HTTPS. Jika Anda menentukan URI koneksi dengan segmen Transportasi, tetapi tidak menentukan port, sesi dibuat dengan port standar: 80 untuk HTTP dan 443 untuk HTTPS. Untuk menggunakan port default untuk remoting PowerShell, tentukan port 5985 untuk HTTP atau 5986 untuk HTTPS.

Jika komputer tujuan mengalihkan koneksi ke URI yang berbeda, PowerShell mencegah pengalihan kecuali Anda menggunakan parameter AllowRedirection dalam perintah.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Parameter ini hanya mendapatkan sesi dari komputer yang menjalankan Windows PowerShell 3.0 atau versi Windows PowerShell yang lebih baru. Versi sebelumnya tidak menyimpan sesi.

Jenis:Uri[]
Alias:URI, CU
Position:0
Nilai default:Http://localhost:5985/WSMAN
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ContainerId

Menentukan array ID kontainer. Cmdlet ini memulai sesi interaktif dengan setiap kontainer yang ditentukan. Gunakan perintah docker ps untuk mendapatkan daftar ID kontainer. Untuk informasi selengkapnya, lihat bantuan untuk perintah ps docker.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Credential

Menentukan kredensial pengguna. Cmdlet ini menjalankan perintah dengan izin pengguna yang ditentukan. Tentukan akun pengguna yang memiliki izin untuk tersambung ke komputer jarak jauh dan jalankan perintah Get-PSSession. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential yang dihasilkan oleh cmdlet Get-Credential. Jika Anda mengetikkan nama pengguna, Anda akan diminta untuk memasukkan kata sandi.

Kredensial disimpan dalam objek PSCredential dan kata sandi disimpan sebagai SecureString.

Nota

Untuk informasi selengkapnya tentang perlindungan data SecureString, lihat Seberapa aman SecureString?.

Parameter ini mengonfigurasi ke koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ComputerName atau ConnectionUri.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:PSCredential
Position:Named
Nilai default:Current user
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Id

Menentukan array ID sesi. Cmdlet ini hanya mendapatkan sesi dengan ID yang ditentukan. Ketik satu atau beberapa ID, dipisahkan oleh koma, atau gunakan operator rentang (..) untuk menentukan rentang ID. Anda tidak dapat menggunakan parameter Id bersama dengan parameter ComputerName.

ID adalah bilangan bulat yang secara unik mengidentifikasi sesi yang dikelola pengguna dalam sesi saat ini. Lebih mudah diingat dan dititik daripada InstanceId, tetapi hanya unik dalam sesi saat ini. ID sesi disimpan di properti Id sesi.

Jenis:Int32[]
Position:0
Nilai default:All sessions
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InstanceId

Menentukan array ID instans sesi. Cmdlet ini hanya mendapatkan sesi dengan ID instans yang ditentukan.

ID instans adalah GUID yang secara unik mengidentifikasi sesi di komputer lokal atau jarak jauh. InstanceId itu unik, bahkan ketika Anda menjalankan beberapa sesi yang sedang berjalan di PowerShell.

ID instans sesi disimpan di properti InstanceId sesi.

Jenis:Guid[]
Position:Named
Nilai default:All sessions
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan array nama sesi. Cmdlet ini hanya mendapatkan sesi yang memiliki nama ramah yang ditentukan. Karakter kartubebas diizinkan.

Nama sesi yang mudah diingat disimpan di properti Nama sesi.

Jenis:String[]
Position:Named
Nilai default:All sessions
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:True

-Port

Menentukan port jaringan yang ditentukan yang digunakan untuk koneksi sementara tempat perintah Get-PSSession dijalankan. Untuk tersambung ke komputer jarak jauh, komputer jarak jauh harus mendengarkan porta yang digunakan koneksi. Port default 5985, yang merupakan port WinRM untuk HTTP, dan 5986, yang merupakan port WinRM untuk HTTPS.

Sebelum menggunakan port alternatif, Anda harus mengonfigurasi pendengar WinRM di komputer jarak jauh untuk mendengarkan di port tersebut. Untuk mengonfigurasi pendengar, ketik dua perintah berikut pada prompt PowerShell:

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

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

Parameter ini mengonfigurasi ke koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ComputerName atau ConnectionUri.

Jangan gunakan parameter Port kecuali Anda harus. Port diatur dalam perintah berlaku untuk semua komputer atau sesi tempat perintah berjalan. Pengaturan port alternatif mungkin mencegah perintah berjalan pada semua komputer.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:Int32
Position:Named
Nilai default:5985, 5986
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SessionOption

Menentukan opsi tingkat lanjut untuk sesi tersebut. Masukkan objek SessionOption, seperti yang Anda buat dengan menggunakan cmdlet New-PSSessionOption, atau tabel hash tempat kunci adalah nama opsi sesi dan nilainya adalah nilai opsi sesi.

Nilai default untuk opsi ditentukan oleh nilai variabel preferensi $PSSessionOption, jika diatur. Jika tidak, nilai default ditetapkan oleh opsi yang diatur dalam konfigurasi sesi.

Nilai opsi sesi lebih diutamakan daripada nilai default untuk sesi yang diatur dalam variabel preferensi $PSSessionOption dan dalam konfigurasi sesi. Namun, mereka tidak lebih diutamakan daripada nilai, kuota, atau batas maksimum yang ditetapkan dalam konfigurasi sesi.

Untuk deskripsi opsi sesi, termasuk nilai default, lihat New-PSSessionOption. Untuk informasi tentang variabel preferensi $PSSessionOption, lihat about_Preference_Variables. Untuk informasi selengkapnya tentang konfigurasi sesi, lihat about_Session_Configurations.

Jenis:PSSessionOption
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-State

Menentukan status sesi. Cmdlet ini hanya mendapatkan sesi dalam status yang ditentukan. Nilai yang dapat diterima untuk parameter ini adalah: All, Opened, Disconnected, Closed, dan Broken. Nilai defaultnya adalah All.

Nilai status sesi relatif terhadap sesi saat ini. Sesi yang tidak dibuat dalam sesi saat ini dan tidak tersambung ke sesi saat ini memiliki status Disconnected bahkan ketika mereka terhubung ke sesi yang berbeda.

Status sesi disimpan di properti Status sesi.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:SessionFilterState
Nilai yang diterima:All, Opened, Disconnected, Closed, Broken
Position:Named
Nilai default:All
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ThrottleLimit

Menentukan jumlah maksimum koneksi bersamaan yang dapat dibuat untuk menjalankan perintah Get-PSSession. Jika Anda menghilangkan parameter ini atau memasukkan nilai 0 (nol), nilai default, 32, digunakan. Batas pembatasan hanya berlaku untuk perintah saat ini, bukan ke sesi atau ke komputer.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:Int32
Position:Named
Nilai default:32
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-UseSSL

Menunjukkan bahwa cmdlet ini menggunakan protokol Secure Sockets Layer (SSL) untuk membuat koneksi tempat perintah Get-PSSession berjalan. Secara default, SSL tidak digunakan. Jika Anda menggunakan parameter ini, tetapi SSL tidak tersedia pada port yang digunakan untuk perintah , perintah gagal.

Parameter ini mengonfigurasi koneksi sementara yang dibuat untuk menjalankan perintah Get-PSSession dengan parameter ComputerName.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-VMId

Menentukan array ID komputer virtual. Cmdlet ini memulai sesi interaktif dengan masing-masing komputer virtual yang ditentukan. Untuk melihat komputer virtual yang tersedia untuk Anda, gunakan perintah berikut:

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

Jenis:Guid[]
Alias:VMGuid
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-VMName

Menentukan array nama komputer virtual. Cmdlet ini memulai sesi interaktif dengan masing-masing komputer virtual yang ditentukan. Untuk melihat komputer virtual yang tersedia untuk Anda, gunakan cmdlet Get-VM.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSSession

Catatan

PowerShell menyertakan alias berikut untuk Get-PSSession:

  • Semua platform:

    • gsn

  • Cmdlet ini mendapatkan sesi yang dikelola pengguna objek PSSession" seperti yang dibuat dengan menggunakan cmdlet New-PSSession, Enter-PSSession, dan Invoke-Command. Ini tidak mendapatkan sesi yang dikelola sistem yang dibuat saat Anda memulai PowerShell.

  • Dimulai di Windows PowerShell 3.0, objek PSSession disimpan di komputer yang berada di sisi server atau menerima akhir koneksi. Untuk mendapatkan sesi yang disimpan di komputer lokal atau komputer jarak jauh, PowerShell membuat sesi sementara ke komputer yang ditentukan dan menjalankan perintah kueri dalam sesi.

  • Untuk mendapatkan sesi yang tersambung ke komputer jarak jauh, gunakan parameter ComputerName atau ConnectionUri untuk menentukan komputer jarak jauh. Untuk memfilter sesi yang Get-PSSession dapatkan, gunakan Nama, id , InstanceId , dan parameter Status. Gunakan parameter yang tersisa untuk mengonfigurasi sesi sementara yang Get-PSSession gunakan.

  • Saat Anda menggunakan parameter ComputerName atau ConnectionUri, Get-PSSession hanya mendapatkan sesi dari komputer yang menjalankan Windows PowerShell 3.0 dan versi PowerShell yang lebih baru.

  • Nilai properti Status dari PSSession relatif terhadap sesi saat ini. Oleh karena itu, nilai Terputus berarti bahwa PSSession tidak terhubung ke sesi saat ini. Namun, tidak berarti bahwa PSSession terputus dari semua sesi. Ini mungkin terhubung ke sesi yang berbeda. Untuk menentukan apakah Anda dapat menyambungkan atau menyambungkan kembali ke PSSession dari sesi saat ini, gunakan properti Ketersediaan.

Nilai KetersediaanNone menunjukkan bahwa Anda dapat tersambung ke sesi. Nilai Sibuk menunjukkan bahwa Anda tidak dapat tersambung ke PSSession karena terhubung ke sesi lain.

Untuk informasi selengkapnya tentang nilai properti status sesi, lihat Enumerasi RunspaceState .

Untuk informasi selengkapnya tentang nilai properti Ketersediaan sesi, lihat Enumerasi RunspaceAvailability.