Aracılığıyla paylaş

Set-RdsHostPool

Modül:
Microsoft.RDInfra.RDPowershell Module

Bir konak havuzunun özelliklerini ayarlar.

Sözdizimi

HP4 EnterprisePublishing 

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

Description

Set-RdsHostPool cmdlet, belirtilen konak havuzunun özelliklerini ayarlar. Bu cmdlet için üç parametre kümesi vardır. İlk olarak, 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: Konak havuzunu derinlik öncelikli yük dengelemeyi kullanacak şekilde 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 dengelemeyi 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 ana bilgisayarına yönlendirilir. MaxSessionLimit parametresi, ilk oturum ana bilgisayarında bu oturum sınırına ulaşılana kadar bağlantılar sonraki oturum ana bilgisayarlarına dağıtılmayacağından, derinlik öncelikli yük dengelemeyi ayarlarken bir gerekliliktir.

Örnek 2: Konak havuzunu genişlik ö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 olarak yönlendirilmesi için genişlik öncelikli yük dengelemeyi kullanacak şekilde ayarlar. MaxSessionLimit parametresi isteğe bağlıdır çünkü genişlik öncelikli modda yük dengeleme, derinlik öncelikli modda yük dengelemeden daha az kısıtlayıcıdır.

Örnek 3: Konak havuzunu doğrulama ortamı olarak kabul edilecek ş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 bir doğrulama konak havuzu olacak şekilde ayarlar. Doğrulama konak havuzu, hizmet güncelleştirmelerini daha hızlı bir tempoda alır ve bu da hizmet değişikliklerini üretimde geniş çapta dağıtılmadan önce test etmenize olanak tanır.

Ö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ıya atanacak kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu doğrudan atamayı kullanacak şekilde ayarlar. Doğrudan atama ile, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekir.

Örnek 5: Konak havuzunu otomatik atamayı 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ıya atanacak kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu otomatik atamayı 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ıya atanacak kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu doğrudan atamayı kullanacak şekilde ayarlar. Doğrudan atama ile, kullanıcının konak havuzuna bağlanmadan önce bir oturum konağına atanması gerekir.

Örnek 5: Konak havuzunu otomatik atamayı 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ıya atanacak kişisel masaüstü oturumu ana bilgisayarını belirlemek için konak havuzunu otomatik atamayı 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ğlanabilmeleri için önce havuzdaki bir oturum ana bilgisayarına doğrudan atanması gerekir.

Parametre özellikleri

Tür:PersonalDesktopAssignmentType
Default value:None
Kabul edilen değerler:Automatic, Direct
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-BreadthFirstLoadBalancer

Konak havuzu için genişlik öncelikli yük dengeleme kullanımını etkinleştirmek için geçiş yapın. Breadth-first, yeni kullanıcı oturumlarının en az sayıda kullanıcı oturumu olan oturum ana bilgisayarına yönlendirildiğini gösterir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP5
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 desteklenen Uzak Masaüstü RDP dosya ayarlarına bakın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP3
Position:Named
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DepthFirstLoadBalancer

Konak havuzu için derinlik öncelikli yük dengeleme kullanımını etkinleştirmek için geçiş yapın. Derinlik öncelikli, yeni kullanıcı oturumlarının, maksimum oturum sınırına henüz ulaşmamış olan en yüksek kullanıcı oturumu sayısına sahip oturum ana bilgisayarına yönlendirildiğini gösterir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP6
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Description

Konak havuzunun açıklaması.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP4
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-FriendlyName

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP4
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-MaxSessionLimit

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

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

HP4
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False
HP5
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Konak havuzunun adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:HostPoolName (Ana Bilgisayar Havuzu)

Parametre kümeleri

(All)
Position:1
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-TenantName

Kiracının adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ValidationEnv

Konak havuzunun doğrulama konak havuzu olarak kabul edilip edilmeyeceğini belirten bir boole öğesi. Doğrulama konak havuzları, hizmet güncelleştirmelerini doğrulama olmayan konak havuzlarından daha hızlı bir tempoda alır ve hizmet değişikliklerini üretime geniş çapta dağıtılmadan önce test etmenize olanak tanır.

Parametre özellikleri

Tür:String
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

System.String

Çıkışlar

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool