Get-PSSession

Modul:

Microsoft.PowerShell.Core Module

Mendapatkan sesi PowerShell di komputer lokal dan jarak jauh.

Sintaks

Name (Default)

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

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 menghapusPSSession .

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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 dari suatu sesi disimpan di properti Runspace.ConnectionInfo.AppName sesi.

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

Properti parameter

Jenis:	String
Nilai default:	All sessions
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Caution

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.

Properti parameter

Jenis:	AuthenticationMechanism
Nilai default:	Default
Nilai yang diterima:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CertificateThumbprint

Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk membuat sesi tempat perintah Get-PSSession berjalan. Masukkan sidik jari 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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ComputerName

Menentukan sekumpulan nama-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.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Cn

Kumpulan parameter

ComputerInstanceId

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	All sessions
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ContainerId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ContainerIdInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMIdInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMNameInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ConnectionUri

Menentukan URI yang menentukan titik akhir koneksi untuk sesi sementara tempat perintah Get-PSSession berjalan. URI harus berkualifikasi lengkap.

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 menentukanConnectionUri , Anda dapat menggunakan parameterUseSSL , 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.

Properti parameter

Jenis:	Uri[]
Nilai default:	Http://localhost:5985/WSMAN
Mendukung wildcard:	False
DontShow:	False
Alias:	URI, CU

Kumpulan parameter

ConnectionUriInstanceId

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ContainerId

Menunjukkan array identifikasi 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 docker ps.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ContainerId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ContainerIdInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSCredential
Nilai default:	Current user
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32[]
Nilai default:	All sessions
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Id

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Guid[]
Nilai default:	All sessions
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ContainerIdInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMIdInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMNameInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

InstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

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

Nama sesi yang mudah diingat disimpan di properti Nama sesi.

Properti parameter

Jenis:	String[]
Nilai default:	All sessions
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

Name

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ContainerId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

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

Properti parameter

Jenis:	Int32
Nilai default:	5985, 5986
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-SessionOption

Menentukan opsi tingkat lanjut untuk sesi tersebut. Masukkan objek SessionOption, seperti yang Anda buat dengan menggunakan cmdlet New-PSSessionOption, atau tabel hash di mana kuncinya 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.

Properti parameter

Jenis:	PSSessionOption
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SessionFilterState
Nilai default:	All
Nilai yang diterima:	All, Opened, Disconnected, Closed, Broken
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ContainerId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ContainerIdInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMIdInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

VMNameInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	32
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUriInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ConnectionUri

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerInstanceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-VMId

Menentukan serangkaian ID dari 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

Properti parameter

Jenis:	Guid[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	VMGuid

Kumpulan parameter

VMId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMIdInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-VMName

Menentukan array nama mesin 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.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

VMName

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

VMNameInstanceId

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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 Ketersediaan None 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.

Link Terkait

• Connect-PSSession
• Disconnect-PSSession
• Receive-PSSession
• Enter-PSSession
• Exit-PSSession
• Invoke-Command
• New-PSSession
• Remove-PSSession
• Tentang_PSSessions
• Tentang_Remote