Set-RdsHostPool

Modul:

WindowsVirtualDesktopPowershell

Nastaví vlastnosti fondu hostitelů.

Syntaxe

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

Description

Rutina Set-RdsHostPool nastaví vlastnosti pro zadaný fond hostitelů. Pro tuto rutinu existují tři sady parametrů. Nejprve se používá k zakázání disků profilů uživatelů. Druhá se používá k povolení disků profilů uživatelů. Třetí se používá k nastavení všech ostatních vlastností fondu hostitelů.

Příklady

Příklad 1: Nastavte fond hostitelů tak, aby používal hloubkové vyrovnávání zatížení.

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        :

Tento příkaz nastaví fond hostitelů tak, aby používal hloubkové vyrovnávání zatížení, aby příchozí uživatelé všichni směrovali na konkrétního hostitele relace, dokud nedosáhne hodnoty MaxSessionLimit, která je v tomto příkladu zadaná jako 10. Parametr MaxSessionLimit je požadavek při nastavování vyrovnávání zatížení první hloubky, protože připojení nebudou distribuována do následných hostitelů relací, dokud nebude dosaženo tohoto limitu relace na prvním hostiteli relace.

Příklad 2: Nastavte fond hostitelů tak, aby používal vyrovnávání zatížení první šířky.

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        :

Tento příkaz nastaví fond hostitelů tak, aby používal vyrovnávání zatížení první šířky, aby příchozí uživatelé měli rovnoměrné přesměrování mezi hostiteli relací ve fondu hostitelů. Parametr MaxSessionLimit je volitelný, protože vyrovnávání zatížení v režimu první šířky je méně omezující než vyrovnávání zatížení v režimu hloubkové první.

Příklad 3: Nastavte fond hostitelů, který se má považovat za ověřovací prostředí

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        :

Tento příkaz nastaví fond hostitelů jako fond hostitelů pro ověření. Fond hostitelů ověřování bude dostávat aktualizace služeb rychleji, takže můžete otestovat všechny změny služby před tím, než se nasadí široce v produkčním prostředí.

Příklad 4: Nastavte fond hostitelů tak, aby používal přímé přiřazení.

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

Tento příkaz nastaví fond hostitelů tak, aby používal přímé přiřazení k určení hostitele relace osobní plochy pro přiřazení uživatele. Při přímém přiřazení musí být uživatel před připojením k fondu hostitelů přiřazen hostiteli relace.

Příklad 5: Nastavení fondu hostitelů na použití automatického přiřazení

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

Tento příkaz nastaví fond hostitelů tak, aby používal automatické přiřazení k určení hostitele relace osobní plochy k přiřazení uživatele. S automatickým přiřazením nemusí být uživatel před připojením k fondu hostitelů hostitelů přiřazen k hostiteli relace.

Příklad 4: Nastavte fond hostitelů tak, aby používal přímé přiřazení.

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

Tento příkaz nastaví fond hostitelů tak, aby používal přímé přiřazení k určení hostitele relace osobní plochy pro přiřazení uživatele. Při přímém přiřazení musí být uživatel před připojením k fondu hostitelů přiřazen hostiteli relace.

Příklad 5: Nastavení fondu hostitelů na použití automatického přiřazení

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

Tento příkaz nastaví fond hostitelů tak, aby používal automatické přiřazení k určení hostitele relace osobní plochy k přiřazení uživatele. S automatickým přiřazením nemusí být uživatel před připojením k fondu hostitelů hostitelů přiřazen k hostiteli relace.

Parametry

-AssignmentType

Typ přiřazení pro fond hostitelů osobní plochy:

• Automatické, což znamená, že uživatelé budou automaticky přiřazeni hostiteli relace při prvním připojení k fondu hostitelů.
• Přímé, což znamená, že uživatelé musí být před připojením přímo přiřazeni k hostiteli relace ve fondu.

Typ:	PersonalDesktopAssignmentType
Přípustné hodnoty:	Automatic, Direct
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BreadthFirstLoadBalancer

Přepnutím povolíte použití vyrovnávání zatížení první šířky pro fond hostitelů. První šířka označuje, že nové uživatelské relace jsou směrovány na hostitele relace s nejmenším počtem uživatelských relací.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CustomRdpProperty

Určuje nastavení protokolu RDP (Remote Desktop Protocol), která se mají zahrnout do souborů .rdp pro všechny programy RemoteApp a vzdálené plochy publikované v této kolekci. Další informace najdete v podporovaných nastavení souborů RDP vzdálené plochy.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DepthFirstLoadBalancer

Přepněte, aby se pro fond hostitelů používalo vyrovnávání zatížení první hloubky. Nejprve hloubka označuje, že nové uživatelské relace jsou směrovány na hostitele relace s nejvyšším počtem uživatelských relací, které ještě nedosáhly maximálního limitu relace.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Description

Popis fondu hostitelů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FriendlyName

Popisný název fondu hostitelů, který se má zobrazit.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MaxSessionLimit

Maximální povolený počet relací na hostitele relace ve fondu hostitelů. Pokud je pro vyrovnávání zatížení nastavený režim hloubky, tato hodnota se používá k určení, kdy zastavit vyrovnávání zatížení uživatelů na jednoho hostitele a začít odesílat uživatele na dalšího hostitele.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název fondu hostitelů.

Typ:	String
Aliasy:	HostPoolName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-TenantName

Název tenanta.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ValidationEnv

Logická hodnota označující, jestli by se fond hostitelů měl považovat za fond hostitelů ověření. Fondy hostitelů ověřování přijímají aktualizace služby rychleji než fondy hostitelů, které nejsou ověřením, což vám umožní otestovat změny služby dříve, než se nasadí široce do produkčního prostředí.

Typ:	String
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Vstupy

System.String

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool