New-RdsHostPool
Tworzy pulę hostów.
Składnia
Default (Domyślna)
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>]
Opis
Tworzy pulę hostów w ramach dzierżawy. Pula hostów zawiera co najmniej jeden host sesji, z którego użytkownicy mogą łączyć się w celu uruchamiania programów, zapisywania plików i korzystania z zasobów na tych hostach.
W czasie tworzenia można zdecydować o utworzeniu trwałej puli hostów przy użyciu flagi trwałej. Tworząc trwałą pulę hostów, użytkownik zawsze będzie łączył się z tym samym hostem sesji dla swoich sesji. Jeśli ta flaga nie zostanie użyta, zostanie utworzona pula hostów w puli. W puli hostów w puli użytkownicy są połączeni z hostem sesji w puli, który jest dynamicznie wybierany 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łniona pewnymi wstępnie zdefiniowanymi wartościami. Aby zmienić te wartości, uruchom polecenie cmdlet Set-RdsHostPool.
Przykład 2: Tworzenie puli hostów komputerów stacjonarnych
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 komputerów stacjonarnych w określonej dzierżawie. Jeśli typ przypisania nie zostanie podany podczas uruchamiania polecenia, pula hostów komputerów osobistych zostanie ustawiona na przypisanie automatyczne. Aby zmienić typ przypisania lub dowolną inną właściwość puli hostów, uruchom Set-RdsHostPool cmdlet.
Przykład 3: Tworzenie puli hostów walidacji
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 w puli z weryfikacją w określonej dzierżawie. 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. Aby zmienić pulę hostów tak, aby nie była już pulą hostów weryfikacji, uruchom Set-RdsHostPool cmdlet.
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 |
-Description
Ciąg składający się z 512 znaków opisujący pulę hostów, aby pomóc administratorom. Dowolny znak jest dozwolony.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| 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 |
-FriendlyName
256-znakowy ciąg przeznaczony do wyświetlania użytkownikom końcowym. Dowolny znak jest dozwolony.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| 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 |
-Name
Nazwa puli hostów, która musi być unikatowa w dzierżawie.
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 |
-Persistent
Przełącznik wskazujący, aby oznaczyć pulę hostów jako trwałą.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| 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 |
-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.