Remove-RdsSessionHost
Menghapus host sesi dari kumpulan host.
Sintaks
Default (Default)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Deskripsi
Cmdlet Remove-RdsSessionHost menghapus host sesi terdaftar dari kumpulan host. Untuk mendaftarkan ulang host sesi ke kumpulan host, Anda harus menginstal ulang agen dengan informasi pendaftaran yang valid untuk kumpulan host tersebut.
Perintah ini akan gagal jika host sesi memiliki sesi pengguna aktif. Untuk menyelesaikan penghapusan host sesi, Anda harus terlebih dahulu keluar dari semua pengguna dari host sesi menggunakan cmdlet Invoke-RdsUserSessionLogoff atau menjalankan kembali cmdlet Remove-RdsSessionHost dengan parameter Force.
Saat menjalankan perintah ini untuk menghapus host sesi dari kumpulan host persisten, penetapan pengguna juga dihapus. Ini adalah satu-satunya cara untuk menetapkan ulang pengguna ke host sesi baru di kumpulan host persisten.
Contoh
Contoh 1: Menghapus host sesi yang tidak memiliki sesi aktif
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Perintah ini menghapus host sesi dari kumpulan host. Dengan menjalankan cmdlet Remove-RdsSessionHost tanpa sakelar Force, cmdlet hanya akan berhasil jika tidak ada sesi aktif pada host sesi yang ditentukan. Untuk memaksa pengguna keluar dari host sesi, Anda dapat menjalankan cmdlet Invoke-RdsUserSessionLogoff.
Contoh 2: Menghapus host sesi menggunakan sakelar paksa
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Perintah ini menghapus host sesi dari kumpulan host. Dengan menjalankan cmdlet Remove-RdsSessionHost dengan sakelar Force, host sesi akan segera dihapus dari database, bersama dengan informasi sesi pengguna. Ini tidak secara otomatis menonaktifkan pengguna dan dapat mengakibatkan pengguna kehilangan status sesi jika mereka secara tidak sengaja terputus dari sesi mereka sebelum melakukan logout.
Parameter
-Force
Memaksa penghapusan host sesi, bahkan jika ada objek sesi pengguna yang terkandung dengan host sesi.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-HostPoolName
Nama HostPool.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | 1 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Nama SessionHost.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Nama Host Sesi |
Set parameter
(All)
| Position: | 2 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-TenantName
Nama penyewa.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| 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.