Remove-PSSession
Menutup satu atau beberapa sesi PowerShell (PSSessions).
Sintaks
Id (Default)
Remove-PSSession
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Session
Remove-PSSession
[-Session] <PSSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ContainerId
Remove-PSSession
-ContainerId <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMId
Remove-PSSession
-VMId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMName
Remove-PSSession
-VMName <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceId
Remove-PSSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Name
Remove-PSSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerName
Remove-PSSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Remove-PSSession menutup sesi PowerShell (PSSessions) dalam sesi saat ini. Ini menghentikan perintah apa pun yang berjalan di PSSessions, mengakhiri PSSession, dan melepaskan sumber daya yang digunakan PSSession. Jika PSSession tersambung ke komputer jarak jauh, cmdlet ini juga menutup koneksi antara komputer lokal dan jarak jauh.
Untuk menghapus PSSession, masukkan Nama, ComputerName, Id, atau InstanceId sesi.
Jika Anda telah menyimpan PSSession dalam variabel, objek sesi tetap berada dalam variabel, tetapi status PSSession Ditutup.
Contoh
Contoh 1: Menghapus sesi menurut ID
Remove-PSSession -Id 1, 2
Perintah ini menghapus PSSessions yang memiliki ID 1 dan 2.
Contoh 2: Hapus semua sesi dalam sesi saat ini
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s
Perintah ini menghapus semua PSSessions dalam sesi saat ini. Meskipun tiga format perintah terlihat berbeda, format tersebut memiliki efek yang sama.
Contoh 3: Tutup sesi menurut nama
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Perintah-perintah ini menutup PSSessions yang terhubung ke komputer yang memiliki nama yang dimulai dengan Serv.
Contoh 4: Tutup sesi yang tersambung ke port
Get-PSSession | where {$_.Port -eq 90} | Remove-PSSession
Perintah ini menutup PSSessions yang tersambung ke port 90. Anda dapat menggunakan format perintah ini untuk mengidentifikasi PSSessions menurut properti selain ComputerName, Name, InstanceId, dan Id.
Contoh 5: Tutup sesi menurut ID instans
Get-PSSession | Format-Table ComputerName, InstanceId -AutoSize
ComputerName InstanceId
------------ ----------------
Server01 875d231b-2788-4f36-9f67-2e50d63bb82a
localhost c065ffa0-02c4-406e-84a3-dacb0d677868
Server02 4699cdbc-61d5-4e0d-b916-84f82ebede1f
Server03 4e5a3245-4c63-43e4-88d0-a7798bfc2414
TX-TEST-01 fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
Remove-PSSession -InstanceId fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
Perintah ini menunjukkan bagaimana cara menutup PSSession berdasarkan ID instansnya, atau RemoteRunspaceID.
Perintah pertama menggunakan cmdlet Get-PSSession untuk mendapatkan sesi PS dalam sesi saat ini.
Ini menggunakan operator alur (|) untuk mengirim PSSessions ke Format-Table cmdlet, yang memformat properti ComputerName dan InstanceId mereka dalam tabel. Parameter AutoSize memadatkan kolom untuk ditampilkan.
Dari tampilan yang dihasilkan, Anda dapat mengidentifikasi PSSession yang akan ditutup, dan menyalin dan menempelkan InstanceIddari PSSession tersebut ke perintah kedua.
Perintah kedua menggunakan cmdlet Remove-PSSession untuk menghapus PSSession dengan ID instans yang ditentukan.
Contoh 6: Membuat fungsi yang menghapus semua sesi dalam sesi saat ini
function EndPSS { Get-PSSession | Remove-PSSession }
Fungsi ini menutup setiap PSSession dalam sesi sekarang. Setelah Anda menambahkan fungsi ini ke profil PowerShell Anda, untuk menghapus semua sesi, ketik EndPSS.
Parameter
-ComputerName
Menentukan sekumpulan nama-nama komputer. Cmdlet ini menutup PSSessions yang tersambung ke komputer yang ditentukan. Karakter pengganti diizinkan.
Ketik nama NetBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat dari satu atau beberapa komputer jarak jauh. Untuk menentukan komputer lokal, ketik nama komputer, localhost, atau titik (.).
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
| Alias: | Cn |
Kumpulan parameter
ComputerName
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ContainerId
Menunjukkan array identifikasi kontainer. Cmdlet ini menghapus sesi untuk 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 |
-Id
Menentukan array ID dari beberapa sesi. Cmdlet ini menutup PSSessions dengan ID yang ditentukan.
Ketik satu atau beberapa ID, dipisahkan oleh koma, atau gunakan operator rentang (..) untuk menentukan rentang ID.
ID adalah bilangan bulat yang secara unik mengidentifikasi PSSession dalam sesi saat ini. Lebih mudah diingat dan dititik daripada InstanceId, tetapi hanya unik dalam sesi saat ini. Untuk menemukan ID PSSession, jalankan cmdlet Get-PSSession tanpa parameter.
Properti parameter
| Jenis: | Int32[] |
| Nilai default: | None |
| 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 sebuah array dari ID instans. Cmdlet ini menutup PSSessions yang memiliki ID instans yang ditentukan.
ID instans adalah GUID yang secara unik mengidentifikasi PSSession dalam sesi saat ini. ID instance bersifat unik, bahkan ketika Anda memiliki beberapa sesi yang berjalan di satu komputer.
ID instans disimpan di properti InstanceId objek yang mewakili PSSession. Untuk menemukan InstanceId dari PSSessions dalam sesi saat ini, ketik Get-PSSession | Format-Table Name, ComputerName, InstanceId.
Properti parameter
| Jenis: | Guid[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
InstanceId
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan array nama sesi yang ramah pengguna. Cmdlet ini menutup PSSessions yang memiliki nama ramah yang ditentukan. Karakter pengganti diizinkan.
Karena nama ramah dari PSSession mungkin tidak unik, saat Anda menggunakan parameter Nama, pertimbangkan juga menggunakan parameter WhatIf atau Confirm dalam perintah tersebut Remove-PSSession.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
Name
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Session
Menentukan objek sesi PSSessions untuk ditutup. Masukkan variabel yang berisi PSSessions atau perintah yang membuat atau mendapatkan PSSessions, seperti perintah New-PSSession atau Get-PSSession. Anda juga dapat menyalurkan satu atau beberapa objek sesi ke Remove-PSSession.
Properti parameter
| Jenis: | |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Session
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| 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 |
-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 |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| 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
PSSession
Anda dapat menyalurkan objek sesi ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
PowerShell menyertakan alias berikut untuk Remove-PSSession:
Semua platform:
rsn
Parameter Id bersifat wajib. Untuk menghapus semua PSSessions dalam sesi saat ini, ketik
Get-PSSession | Remove-PSSession.PSSession menggunakan koneksi persisten ke komputer jarak jauh. Buat PSSession untuk menjalankan serangkaian perintah yang berbagi data. Untuk informasi selengkapnya, ketik
Get-Help about_PSSessions.PSSessions khusus untuk sesi saat ini. Saat Anda mengakhiri sesi, PSSessions yang Anda buat dalam sesi tersebut ditutup secara paksa.
