Bagikan melalui

Set-RdsHostPool

  • Referensi
Modul:
WindowsVirtualDesktopPowershell

Mengatur properti untuk kumpulan host.

Sintaks

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-FriendlyName <String>]
   [-Description <String>]
   [-MaxSessionLimit <Int32>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]
Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-BreadthFirstLoadBalancer]
   [-MaxSessionLimit <Int32>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]
Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-DepthFirstLoadBalancer]
   -MaxSessionLimit <Int32>
   [-ValidationEnv <bool>]
    [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]
Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-CustomRdpProperty <String>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]
Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-ValidationEnv <bool>]
   [-Ring <int>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-RdsHostPool mengatur properti untuk kumpulan host yang ditentukan. Ada tiga set parameter untuk cmdlet ini. Pertama digunakan untuk menonaktifkan disk profil pengguna. Yang kedua digunakan untuk mengaktifkan disk profil pengguna. Yang ketiga digunakan untuk mengatur semua properti lain dari kumpulan host.

Contoh

Contoh 1: Atur kumpulan host untuk menggunakan penyeimbangan beban yang mengutamakan kedalaman

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -DepthFirstLoadBalancer -MaxSessionLimit 10

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 10
LoadBalancerType      : DepthFirst
ValidationEnv         : False
Ring                  : 
AssignmentType        :

Perintah ini mengatur kumpulan host untuk menggunakan penyeimbangan beban yang mengutamakan kedalaman, sehingga pengguna masuk semuanya akan diarahkan ke host sesi tertentu sampai mencapai MaxSessionLimit, yang ditentukan sebagai 10 dalam contoh ini. Parameter MaxSessionLimit adalah persyaratan saat mengatur penyeimbangan beban yang mengutamakan kedalaman karena koneksi tidak akan didistribusikan ke host sesi berikutnya hingga batas sesi ini tercapai pada host sesi pertama.

Contoh 2: Atur kumpulan host untuk menggunakan penyeimbangan beban yang mengutamakan luas

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -BreadthFirstLoadBalancer

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 10
LoadBalancerType      : BreadthFirst
ValidationEnv         : False
Ring                  : 
AssignmentType        :

Perintah ini mengatur kumpulan host untuk menggunakan penyeimbangan beban yang mengutamakan luas, sehingga pengguna yang masuk akan diarahkan secara merata di seluruh host sesi di kumpulan host. Parameter MaxSessionLimit bersifat opsional karena penyeimbangan beban dalam mode breadth-first kurang ketat daripada penyeimbangan beban dalam mode depth-first.

Contoh 3: Atur kumpulan host untuk diperlakukan sebagai lingkungan validasi

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -ValidationEnv $true

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     : use multimon:i:0;
MaxSessionLimit       : 10
LoadBalancerType      : BreadthFirst
ValidationEnv         : True
Ring                  : 
AssignmentType        :

Perintah ini mengatur kumpulan host menjadi kumpulan host validasi. Kumpulan host validasi akan menerima pembaruan layanan dengan irama yang lebih cepat, memungkinkan Anda menguji perubahan layanan apa pun sebelum disebarkan secara luas dalam produksi.

Contoh 4: Atur kumpulan host untuk menggunakan penetapan langsung

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     : 
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  : 
AssignmentType        : Direct

Perintah ini mengatur kumpulan host untuk menggunakan penetapan langsung untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penetapan langsung, pengguna harus ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Contoh 5: Atur kumpulan host untuk menggunakan penugasan otomatis

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     : 
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  : 
AssignmentType        : Automatic

Perintah ini mengatur kumpulan host untuk menggunakan penugasan otomatis untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penugasan otomatis, pengguna tidak perlu ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Contoh 4: Atur kumpulan host untuk menggunakan penetapan langsung

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     : 
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  : 
AssignmentType        : Direct

Perintah ini mengatur kumpulan host untuk menggunakan penetapan langsung untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penetapan langsung, pengguna harus ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Contoh 5: Atur kumpulan host untuk menggunakan penugasan otomatis

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     : 
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  : 
AssignmentType        : Automatic

Perintah ini mengatur kumpulan host untuk menggunakan penugasan otomatis untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penugasan otomatis, pengguna tidak perlu ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Parameter

-AssignmentType

Jenis penugasan untuk kumpulan host desktop pribadi:

  • Otomatis, yang berarti pengguna akan secara otomatis diberi host sesi pada koneksi pertama mereka ke kumpulan host.
  • Langsung, yang berarti pengguna harus langsung ditetapkan ke host sesi di kumpulan sebelum mereka dapat terhubung.
Jenis:PersonalDesktopAssignmentType
Nilai yang diterima:Automatic, Direct
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-BreadthFirstLoadBalancer

Beralih untuk mengaktifkan penggunaan penyeimbangan beban yang mengutamakan luas untuk kumpulan host. Breadth-first menunjukkan bahwa sesi pengguna baru diarahkan ke host sesi dengan jumlah sesi pengguna paling sedikit.

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

-CustomRdpProperty

Menentukan pengaturan Protokol Desktop Jauh (RDP) untuk disertakan dalam file .rdp untuk semua program RemoteApp dan desktop jarak jauh yang diterbitkan dalam koleksi ini. Lihat pengaturan file RDP Desktop Jauh yang didukung untuk informasi selengkapnya.

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

-DepthFirstLoadBalancer

Beralih untuk mengaktifkan penggunaan penyeimbangan beban yang mengutamakan kedalaman untuk kumpulan host. Depth-first menunjukkan bahwa sesi pengguna baru diarahkan ke host sesi dengan jumlah sesi pengguna tertinggi yang belum mencapai batas sesi maksimumnya.

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

-Description

Deskripsi untuk kumpulan host.

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

-FriendlyName

Nama yang mudah diingat dari kumpulan host yang akan ditampilkan.

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

-MaxSessionLimit

Jumlah maksimum sesi yang diizinkan per host sesi di kumpulan host. Saat mode depth-first diatur untuk penyeimbangan beban, nilai ini digunakan untuk menentukan kapan harus menghentikan pengguna penyeimbangan beban ke satu host dan untuk mulai mengirim pengguna ke host berikutnya.

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

-Name

Nama kumpulan host.

Jenis:String
Alias:HostPoolName
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-TenantName

Nama penyewa.

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

-ValidationEnv

Boolean yang menunjukkan apakah kumpulan host harus diperlakukan sebagai kumpulan host validasi. Kumpulan host validasi menerima pembaruan layanan dengan irama yang lebih cepat daripada kumpulan host non-validasi, memungkinkan Anda menguji perubahan layanan sebelum disebarkan secara luas ke produksi.

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

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool