Share via

Set-RdsHostPool

  • Başvuru
Modül:
WindowsVirtualDesktopPowershell

Konak havuzunun özelliklerini ayarlar.

Syntax

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

Description

Set-RdsHostPool cmdlet'i belirtilen konak havuzunun özelliklerini ayarlar. Bu cmdlet için üç parametre kümesi var. İlki, kullanıcı profili disklerini devre dışı bırakmak için kullanılır. İkincisi, kullanıcı profili disklerini etkinleştirmek için kullanılır. Üçüncüsü, konak havuzunun diğer tüm özelliklerini ayarlamak için kullanılır.

Örnekler

Örnek 1: Derinlik öncelikli yük dengelemeyi kullanmak için konak havuzunu ayarlama

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        :

Bu komut, konak havuzunu derinlik öncelikli yük dengeleme kullanacak şekilde ayarlar; böylece gelen kullanıcıların tümü, bu örnekte 10 olarak belirtilen MaxSessionLimit değerine ulaşana kadar belirli bir oturum konağına yönlendirilir. MaxSessionLimit parametresi, ilk oturum ana bilgisayarında bu oturum sınırına ulaşılana kadar bağlantılar sonraki oturum konaklarına dağıtılmayacağı için derinlik öncelikli yük dengelemeyi ayarlarken bir gereksinimdir.

Örnek 2: Konak havuzunu içerik öncelikli yük dengelemeyi kullanacak şekilde ayarlama

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        :

Bu komut, konak havuzunu, gelen kullanıcıların konak havuzundaki oturum konakları arasında eşit bir şekilde yönlendirilmesi için içerik öncelikli yük dengeleme kullanacak şekilde ayarlar. MaxSessionLimit parametresi isteğe bağlıdır çünkü birinci genişlik modunda yük dengeleme, derinlik öncelikli modda yük dengelemeye kıyasla daha az kısıtlayıcıdır.

Örnek 3: Konak havuzunu doğrulama ortamı olarak işlenecek şekilde ayarlama

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        :

Bu komut konak havuzunu doğrulama konak havuzu olarak ayarlar. Doğrulama ana bilgisayar havuzu, hizmet güncelleştirmelerini daha hızlı bir tempoda alır ve bu sayede hizmet değişikliklerini üretimde geniş bir şekilde dağıtılmadan önce test edebilirsiniz.

Örnek 4: Konak havuzunu doğrudan atama kullanacak şekilde ayarlama

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

Bu komut, kullanıcıyı atamak üzere kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu doğrudan atama kullanacak şekilde ayarlar. Doğrudan atamada, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekir.

Örnek 5: Konak havuzunu otomatik atama kullanacak şekilde ayarlama

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

Bu komut, kullanıcıyı atayacak kişisel masaüstü oturumu konalığını belirlemek için konak havuzunu otomatik atama kullanacak şekilde ayarlar. Otomatik atama ile, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekmez.

Örnek 4: Konak havuzunu doğrudan atama kullanacak şekilde ayarlama

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

Bu komut, kullanıcıyı atamak üzere kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu doğrudan atama kullanacak şekilde ayarlar. Doğrudan atamada, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekir.

Örnek 5: Konak havuzunu otomatik atama kullanacak şekilde ayarlama

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

Bu komut, kullanıcıyı atayacak kişisel masaüstü oturumu konalığını belirlemek için konak havuzunu otomatik atama kullanacak şekilde ayarlar. Otomatik atama ile, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekmez.

Parametreler

-AssignmentType

Kişisel masaüstü konak havuzu için atama türü:

  • Otomatik, yani kullanıcılara konak havuzuna ilk bağlantılarında otomatik olarak bir oturum konağı atanır.
  • Doğrudan, yani kullanıcıların bağlanabilmesi için havuzdaki bir oturum konağına doğrudan atanması gerekir.
Type:PersonalDesktopAssignmentType
Accepted values:Automatic, Direct
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BreadthFirstLoadBalancer

Konak havuzu için içerik öncelikli yük dengeleme kullanımını etkinleştirmeye geçin. Breadth-first, yeni kullanıcı oturumlarının en az sayıda kullanıcı oturumuyla oturum konağına yönlendirildiğini gösterir.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomRdpProperty

Bu koleksiyonda yayımlanan tüm RemoteApp programları ve uzak masaüstleri için .rdp dosyalarına eklenecek Uzak Masaüstü Protokolü (RDP) ayarlarını belirtir. Daha fazla bilgi için bkz. desteklenen Uzak Masaüstü RDP dosya ayarları .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DepthFirstLoadBalancer

Konak havuzu için derinlik öncelikli yük dengeleme kullanımını etkinleştirmeye geçin. Derinlik öncelikli, yeni kullanıcı oturumlarının en yüksek oturum sınırına ulaşmamış en fazla sayıda kullanıcı oturumuna sahip oturum konağına yönlendirildiğini gösterir.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Konak havuzunun açıklaması.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FriendlyName

Görüntülenecek konak havuzunun kolay adı.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSessionLimit

Konak havuzunda oturum konağı başına izin verilen en fazla oturum sayısı. Derinlik öncelikli mod yük dengeleme için ayarlandığında bu değer, yük dengeleme kullanıcılarının bir konağa ne zaman durdurulacağını belirlemek ve kullanıcıları bir sonraki konağa göndermeye başlamak için kullanılır.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Konak havuzunun adı.

Type:String
Aliases:HostPoolName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantName

Kiracının adı.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ValidationEnv

Konak havuzunun doğrulama konak havuzu olarak ele alınıp alınmadığını gösteren boole değeri. Doğrulama konak havuzları, hizmet güncelleştirmelerini doğrulama olmayan konak havuzlarına göre daha hızlı alır ve bu sayede hizmet değişikliklerini üretim ortamına yaygın olarak dağıtılmadan önce test edebilirsiniz.

Type:String
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Girişler

System.String

Çıkışlar

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool