Set-RdsHostPool

Modul:

Microsoft.RDInfra.RDPowershell Module

Mengatur properti untuk kumpulan host.

Sintaks

HP4 (Default)

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-FriendlyName <String>]
    [-Description <String>]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP5

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-BreadthFirstLoadBalancer]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP6

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    -MaxSessionLimit <Int32>
    [-DepthFirstLoadBalancer]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP3

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-CustomRdpProperty <String>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP7

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [<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 kedalaman pertama

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 kedalaman, sehingga semua pengguna yang masuk akan diarahkan ke host sesi tertentu hingga mencapai MaxSessionLimit, yang ditentukan sebagai 10 dalam contoh ini. Parameter MaxSessionLimit adalah persyaratan saat mengatur penyeimbangan beban depth-first karena koneksi tidak akan didistribusikan ke host sesi berikutnya hingga batas sesi ini tercapai pada host sesi pertama.

Contoh 2: Mengatur kumpulan host untuk menggunakan penyeimbangan beban width-first

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, sehingga pengguna yang masuk akan diarahkan secara merata di seluruh host sesi di kumpulan host. Parameter MaxSessionLimit bersifat opsional karena penyeimbangan beban dalam mode lebar pertama kurang ketat daripada penyeimbangan beban dalam mode kedalaman-pertama.

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 pada irama yang lebih cepat, memungkinkan Anda menguji perubahan layanan apa pun sebelum disebarkan secara luas dalam produksi.

Contoh 4: Mengatur 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: Mengatur kumpulan host untuk menggunakan penetapan 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 penetapan otomatis untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penetapan otomatis, pengguna tidak perlu ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Contoh 4: Mengatur 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: Mengatur kumpulan host untuk menggunakan penetapan 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 penetapan otomatis untuk menentukan host sesi desktop pribadi untuk menetapkan pengguna. Dengan penetapan otomatis, pengguna tidak perlu ditetapkan ke host sesi sebelum menyambungkan ke kumpulan host.

Parameter

-AssignmentType

Jenis penugasan untuk kumpulan host desktop pribadi:

• Otomatis, artinya pengguna akan secara otomatis ditetapkan host sesi pada koneksi pertama mereka ke kumpulan host.
• Langsung, artinya pengguna harus langsung ditetapkan ke host sesi di kumpulan sebelum mereka dapat terhubung.

Properti parameter

Jenis:	PersonalDesktopAssignmentType
Nilai default:	None
Nilai yang diterima:	Automatic, Direct
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

-BreadthFirstLoadBalancer

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

Properti parameter

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

Set parameter

HP5

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

-CustomRdpProperty

Menentukan pengaturan Protokol Desktop Jarak 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 Jarak Jauh yang didukung untuk informasi selengkapnya.

Properti parameter

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

Set parameter

HP3

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

-DepthFirstLoadBalancer

Beralih untuk mengaktifkan penggunaan penyeimbangan beban kedalaman pertama 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.

Properti parameter

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

Set parameter

HP6

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

-Description

Deskripsi untuk kumpulan host.

Properti parameter

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

Set parameter

HP4

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

-FriendlyName

Nama ramah kumpulan host yang akan ditampilkan.

Properti parameter

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

Set parameter

HP4

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 penyeimbangan beban pengguna ke satu host dan mulai mengirim pengguna ke host berikutnya.

Properti parameter

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

Set parameter

HP4

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

HP5

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

-Name

Nama kumpulan host.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Nama HostPool

Set parameter

(All)

Position:	1
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

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

Properti parameter

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

Set parameter

(All)

Position:	Named
Wajib:	False
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.

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool