Set-RdsHostPool
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.
Typ: | PersonalDesktopAssignmentType |
Dopuszczalne wartości: | Automatic, Direct |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 .
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Description
Opis puli hostów.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-FriendlyName
Przyjazna nazwa puli hostów do wyświetlenia.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa puli hostów.
Typ: | String |
Aliasy: | HostPoolName |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-TenantName
Nazwa dzierżawy.
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | String |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
System.String
Dane wyjściowe
Microsoft.RDInfra.RDManagementData.RdMgmtHostPool