Set-RdsHostPool

Moduł:

Microsoft.RDInfra.RDPowershell Module

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

Składnia

HP4 (Domyślna)

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

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 tak, aby używała równoważenia obciążenia w pierwszej kolejności w głąb

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 tak, aby używała równoważenia obciążenia najpierw w głąb, tak aby wszyscy użytkownicy przychodzący byli kierowani do określonego hosta sesji, dopóki nie osiągnie wartości MaxSessionLimit, która w tym przykładzie jest określona jako 10. 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 tak, aby używała 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 najpierw wszerz, tak aby użytkownicy przychodzący byli równomiernie kierowani między hostami sesji w puli hostów. Parametr MaxSessionLimit jest opcjonalny, ponieważ równoważenie obciążenia w trybie najpierw szerokości jest mniej restrykcyjne niż równoważenie obciążenia w trybie najpierw w głąb.

Przykład 3: Ustawianie puli hostów, która ma być traktowana jako środowisko walidacji

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 walidacji. Pula hostów weryfikacji będzie otrzymywać aktualizacje usług w szybszym tempie, co pozwoli na przetestowanie wszelkich zmian w usłudze przed ich szerokim wdrożeniem w środowisku produkcyjnym.

Przykład 4: Ustawianie puli hostów do korzystania z 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 tak, aby używała bezpośredniego przypisania w celu określenia hosta sesji pulpitu osobistego, który ma zostać przypisany do użytkownika. W przypadku bezpośredniego przypisania użytkownik musi być przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Przykład 5: Ustawianie puli hostów do korzystania z automatycznego przypisywania

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 tak, aby używała automatycznego przypisywania w celu określenia hosta sesji pulpitu osobistego, który ma zostać przypisany do użytkownika. Dzięki automatycznemu przypisywaniu 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 korzystania z 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 tak, aby używała bezpośredniego przypisania w celu określenia hosta sesji pulpitu osobistego, który ma zostać przypisany do użytkownika. W przypadku bezpośredniego przypisania użytkownik musi być przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Przykład 5: Ustawianie puli hostów do korzystania z automatycznego przypisywania

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 tak, aby używała automatycznego przypisywania w celu określenia hosta sesji pulpitu osobistego, który ma zostać przypisany do użytkownika. Dzięki automatycznemu przypisywaniu użytkownik nie musi być przypisany do hosta sesji przed nawiązaniem połączenia z pulą hostów.

Parametry

-AssignmentType

Typ przypisania dla puli hostów komputerów osobistych:

• Automatycznie, co oznacza, że użytkownicy zostaną automatycznie przypisani do hosta sesji przy 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.

Właściwości parametru

Typ:	PersonalDesktopAssignmentType
Domyślna wartość:	None
Dopuszczalne wartości:	Automatic, Direct
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-BreadthFirstLoadBalancer

Przełącz, aby włączyć korzystanie z równoważenia obciążenia najpierw dla puli hostów. Szerokość pierwsza wskazuje, że nowe sesje użytkowników są kierowane do hosta sesji z najmniejszą liczbą sesji użytkownika.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP5

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-CustomRdpProperty

Określa ustawienia protokołu RDP (Remote Desktop Protocol), które mają być uwzględniane 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 plików RDP pulpitu zdalnego .

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP3

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DepthFirstLoadBalancer

Przełącz, aby włączyć korzystanie z równoważenia obciążenia w pierwszej kolejności dla puli hostów. Głębokość najpierw wskazuje, że nowe sesje użytkowników są kierowane do hosta sesji z największą liczbą sesji użytkowników, która nie osiągnęła jeszcze maksymalnego limitu sesji.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP6

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Description

Opis puli hostów.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP4

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FriendlyName

Przyjazna nazwa puli hostów, która ma być wyświetlana.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP4

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-MaxSessionLimit

Maksymalna dozwolona liczba sesji na hosta sesji w puli hostów. Gdy dla równoważenia obciążenia ustawiono tryb najpierw głębokość, ta wartość jest używana do określania, kiedy należy zatrzymać równoważenie obciążenia użytkowników na jednym hoście i rozpocząć wysyłanie użytkowników do następnego hosta.

Właściwości parametru

Typ:	Int32
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

HP4

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

HP5

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Name

Nazwa puli hostów.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	HostPoolName (Nazwa puli hostów)

Zestawy parametrów

(All)

Position:	1
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-TenantName

Nazwa dzierżawy.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	0
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-ValidationEnv

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

Właściwości parametru

Typ:	String
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

System.String

Dane wyjściowe

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool