Set-RdsHostPool

  • Odwołanie
Moduł:
WindowsVirtualDesktopPowershell

Ustawia właściwości puli hostów.

Składnia

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

Opis

Polecenie cmdlet Set-RdsHostPool ustawia właściwości określonej puli hostów. Dla tego polecenia cmdlet istnieją trzy zestawy parametrów. Pierwszy służy do wyłączania dysków profilu użytkownika. Drugi służy do włączania dysków profilu użytkownika. Trzeci służy do ustawiania wszystkich innych właściwości puli hostów.

Przykłady

Przykład 1. Ustawianie puli hostów do używania funkcji równoważenia obciążenia w pierwszej części

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        :

To polecenie ustawia pulę hostów w celu używania równoważenia obciążenia w pierwszej części, tak aby wszyscy przychodzący użytkownicy mogli być kierowani do określonego hosta sesji, dopóki nie osiągnie wartości MaxSessionLimit, która jest określona jako 10 w tym przykładzie. Parametr MaxSessionLimit jest wymagany podczas ustawiania równoważenia obciążenia w pierwszej kolejności, ponieważ połączenia nie będą dystrybuowane do kolejnych hostów sesji, dopóki ten limit sesji nie zostanie osiągnięty na pierwszym hoście sesji.

Przykład 2. Ustawianie puli hostów do używania równoważenia obciążenia w pierwszej kolejności

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        :

To polecenie ustawia pulę hostów tak, aby używała równoważenia obciążenia w pierwszej kolejności, tak aby przychodzący użytkownicy mogli być równomiernie kierowani między hostami sesji w puli hostów. Parametr MaxSessionLimit jest opcjonalny, ponieważ równoważenie obciążenia w trybie pierwszego zakresu jest mniej restrykcyjne niż równoważenie obciążenia w trybie pierwszego poziomu.

Przykład 3. Ustawianie puli hostów do traktowania jako środowiska sprawdzania poprawności

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        :

To polecenie ustawia pulę hostów jako pulę hostów weryfikacji. Pula hostów weryfikacji będzie otrzymywać aktualizacje usługi w szybszym tempie, co pozwala przetestować wszelkie zmiany usługi przed ich wdrożeniem w środowisku produkcyjnym.

Przykład 4. Ustawianie puli hostów do używania przypisania bezpośredniego

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

To polecenie ustawia pulę hostów do użycia przypisania bezpośredniego w celu określenia hosta sesji pulpitu osobistego w celu przypisania użytkownika. W przypadku przypisania bezpośredniego użytkownik musi zostać przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Przykład 5. Ustawianie puli hostów do używania automatycznego przypisania

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

To polecenie ustawia pulę hostów do użycia automatycznego przypisania w celu określenia hosta sesji pulpitu osobistego w celu przypisania użytkownika. W przypadku automatycznego przypisania użytkownik nie musi być przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Przykład 4. Ustawianie puli hostów do używania przypisania bezpośredniego

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

To polecenie ustawia pulę hostów do użycia przypisania bezpośredniego w celu określenia hosta sesji pulpitu osobistego w celu przypisania użytkownika. W przypadku przypisania bezpośredniego użytkownik musi zostać przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Przykład 5. Ustawianie puli hostów do używania automatycznego przypisania

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

To polecenie ustawia pulę hostów do użycia automatycznego przypisania w celu określenia hosta sesji pulpitu osobistego w celu przypisania użytkownika. W przypadku automatycznego przypisania użytkownik nie musi być przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Parametry

-AssignmentType

Typ przypisania dla osobistej puli hostów pulpitu:

  • Automatycznie, co oznacza, że użytkownicy będą automatycznie przypisywani hostowi sesji w pierwszym połączeniu z pulą hostów.
  • Bezpośrednie, co oznacza, że użytkownicy muszą być bezpośrednio przypisani do hosta sesji w puli, zanim będą mogli nawiązać połączenie.
Type:PersonalDesktopAssignmentType
Accepted values:Automatic, Direct
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BreadthFirstLoadBalancer

Przełącz się, aby włączyć używanie równoważenia obciążenia w pierwszej kolejności dla puli hostów. Zakres pierwszy wskazuje, że nowe sesje użytkownika są kierowane do hosta sesji z najmniejszą liczbą sesji użytkownika.

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

-CustomRdpProperty

Określa ustawienia protokołu RDP (Remote Desktop Protocol) do uwzględnienia w plikach RDP dla wszystkich programów RemoteApp i pulpitów zdalnych opublikowanych w tej kolekcji. Aby uzyskać więcej informacji, zobacz obsługiwane ustawienia pliku RDP pulpitu zdalnego .

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

-DepthFirstLoadBalancer

Przełącz się, aby włączyć używanie funkcji równoważenia obciążenia typu "depth-first" dla puli hostów. Funkcja Depth-first wskazuje, że nowe sesje użytkownika są kierowane do hosta sesji z największą liczbą sesji użytkowników, które nie osiągnęły jeszcze maksymalnego limitu sesji.

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

-Description

Opis puli hostów.

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

-FriendlyName

Przyjazna nazwa puli hostów do wyświetlenia.

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

-MaxSessionLimit

Maksymalna dozwolona liczba sesji na hosta sesji w puli hostów. Po ustawieniu trybu pierwszego głębokości na potrzeby równoważenia obciążenia ta wartość służy do określania, kiedy zatrzymać równoważenie obciążenia użytkowników na jednym hoście i rozpocząć wysyłanie użytkowników do następnego hosta.

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

-Name

Nazwa puli hostów.

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

-TenantName

Nazwa dzierżawy.

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

-ValidationEnv

Wartość logiczna wskazująca, czy pula hostów powinna być traktowana jako pula hostów weryfikacji. Pule hostów weryfikacji otrzymują aktualizacje usługi w szybszym tempie niż pule hostów bez walidacji, co umożliwia testowanie zmian usługi przed ich wdrożeniem w środowisku produkcyjnym.

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

Dane wejściowe

System.String

Dane wyjściowe

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool