New-RdsHostPool
Tworzy pulę hostów.
Składnia
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-AssignmentType {Automatic | Direct}]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>]
Opis
Tworzy pulę hostów w ramach dzierżawy. Pula hostów zawiera co najmniej jeden host sesji, na którym użytkownicy mogą łączyć się z uruchamianiem programów, zapisywać pliki i używać zasobów na tych hostach.
W czasie tworzenia możesz zdecydować się na utworzenie trwałej puli hostów przy użyciu flagi trwałej. Tworząc stałą pulę hostów, użytkownik będzie zawsze łączyć się z tym samym hostem sesji na potrzeby sesji. Jeśli nie używasz tej flagi, zostanie utworzona pula hostów w puli. W puli hostów w puli użytkownicy są połączeni z hostem sesji w puli, która jest dynamicznie wybierana przez moduł równoważenia obciążenia.
Przykłady
Przykład 1. Tworzenie puli hostów w puli
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoHostPool"
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoHostPool
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : BreadthFirst
ValidationEnv : False
Ring :
AssignmentType :
To polecenie tworzy nową pulę hostów w puli w określonej dzierżawie. Pula hostów jest wypełniana niektórymi wstępnie zdefiniowanymi wartościami. Aby zmienić te wartości, uruchom polecenie cmdlet Set-RdsHostPool.
Przykład 2. Tworzenie osobistej puli hostów pulpitu
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoPersonal" -Persistent
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoPersonal
FriendlyName :
Description :
Persistent : True
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : False
Ring :
AssignmentType : Automatic
To polecenie tworzy nową pulę hostów pulpitu osobistego w określonej dzierżawie. Jeśli nie podasz typu przypisania podczas uruchamiania polecenia, zostanie ustawiona pula hostów pulpitu osobistego na automatyczne przypisanie. Aby zmienić typ przypisania lub dowolną inną właściwość puli hostów, uruchom polecenie cmdlet Set-RdsHostPool.
Przykład 3. Tworzenie puli hostów weryfikacji
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoValidation" -ValidationEnv $true
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoValidation
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : True
Ring :
AssignmentType : Automatic
To polecenie tworzy nową pulę hostów weryfikacji w puli w określonej dzierżawie. Pula hostów weryfikacji będzie otrzymywać aktualizacje usług w szybszym tempie, co pozwala przetestować wszelkie zmiany usługi przed ich wdrożeniem w środowisku produkcyjnym. Aby zmienić pulę hostów, aby nie była już pulą hostów weryfikacji, uruchom polecenie cmdlet Set-RdsHostPool.
Parametry
-AssignmentType
Typ przypisania dla osobistej puli hostów pulpitu:
- Automatyczne, co oznacza, że użytkownicy zostaną automatycznie przypisani 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 |
-Description
Ciąg znaków 512 opisujący pulę hostów, aby pomóc administratorom. Dowolny znak jest dozwolony.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-FriendlyName
256-znakowy ciąg przeznaczony do wyświetlania użytkownikom końcowym. Dowolny znak jest dozwolony.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa puli hostów, która musi być unikatowa w dzierżawie.
Typ: | String |
Aliasy: | HostPoolName |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Persistent
Przełącznik wskazujący, aby oznaczyć pulę hostów jako trwałą.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
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ług w szybszym tempie niż pule hostów bez walidacji, co umożliwia testowanie zmian usługi przed ich szeroko wdrożonym 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