Set-RdsHostPool

Modul:

Microsoft.RDInfra.RDPowershell Module

Nastaví vlastnosti fondu hostitelů.

Syntaxe

HP4 (Výchozí)

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

Description

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

Příklady

Příklad 1: Nastavení fondu hostitelů pro použití vyrovnávání zatížení do hloubky

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 vyrovnávání zatížení nejprve do hloubky, takže všichni příchozí uživatelé budou přesměrováni na konkrétního hostitele relace, dokud nedosáhne hodnoty MaxSessionLimit, která je v tomto příkladu zadána jako 10. Parametr MaxSessionLimit je požadavkem při nastavování vyrovnávání zatížení do hloubky, protože připojení nebudou distribuována dalším hostitelům relací, dokud nebude dosaženo tohoto limitu relace na prvním hostiteli relace.

Příklad 2: Nastavení fondu hostitelů pro použití vyrovnávání zatížení do šíř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í do šířky, takže příchozí uživatelé budou rovnoměrně směrováni mezi hostiteli relací ve fondu hostitelů. Parametr MaxSessionLimit je volitelný, protože vyrovnávání zatížení v režimu zaměřeném na šířku je méně omezující než vyrovnávání zatížení v režimu zaměřeném na hloubku.

Příklad 3: Nastavení fondu hostitelů tak, aby se s ním zacházelo jako s ověřovacím prostředím

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ů na fond ověřovacích hostitelů. Fond hostitelů pro ověření bude dostávat aktualizace služeb s rychlejším tempem, což vám umožní otestovat všechny změny služeb před jejich širokým nasazením v produkčním prostředí.

Příklad 4: Nastavení fondu hostitelů pro použití přímého 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 osobní relace plochy, který má uživatele přiřadit. Při přímém přiřazení musí být uživatel před připojením k fondu hostitelů přiřazen k hostiteli relace.

Příklad 5: Nastavení fondu hostitelů pro 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 osobní relace plochy, který má uživatele přiřadit. Díky automatickému přiřazení nemusí být uživatel před připojením k fondu hostitelů přiřazen k hostiteli relace.

Příklad 4: Nastavení fondu hostitelů pro použití přímého 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 osobní relace plochy, který má uživatele přiřadit. Při přímém přiřazení musí být uživatel před připojením k fondu hostitelů přiřazen k hostiteli relace.

Příklad 5: Nastavení fondu hostitelů pro 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 osobní relace plochy, který má uživatele přiřadit. Díky automatickému přiřazení nemusí být uživatel před připojením k fondu hostitelů přiřazen k hostiteli relace.

Parametry

-AssignmentType

Typ přiřazení pro fond hostitelů osobního počítače:

• Automaticky, což znamená, že uživatelům bude při prvním připojení k fondu hostitelů automaticky přiřazen hostitel relace.
• Přímé, což znamená, že uživatelé musí být přímo přiřazeni k hostiteli relace ve fondu, aby se mohli připojit.

Vlastnosti parametru

Typ:	PersonalDesktopAssignmentType
Default value:	None
Přípustné hodnoty:	Automatic, Direct
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-BreadthFirstLoadBalancer

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP5

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CustomRdpProperty

Určuje nastavení protokolu RDP (Remote Desktop Protocol), které se má zahrnout do souborů RDP pro všechny aplikace RemoteApp a vzdálené plochy publikované v této kolekci. Další informace naleznete v tématu Podporovaná nastavení souboru RDP vzdálené plochy .

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP3

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DepthFirstLoadBalancer

Přepněte a povolte použití vyrovnávání zatížení s hloubkou pro fond hostitelů. Hloubka nejprve 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áhl maximálního limitu relace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP6

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Description

Popis fondu hostitelů.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP4

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FriendlyName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP4

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaxSessionLimit

Maximální počet relací povolených na jednoho hostitele relace ve fondu hostitelů. Pokud je pro vyrovnávání zátěže nastaven režim Hloubka první, používá se tato hodnota k určení, kdy se má rozložení zátěže pro uživatele přestat předávat do jednoho hostitele a kdy se mají začít posílat uživatelé na dalšího hostitele.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

HP4

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

HP5

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Název fondu hostitelů.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název_fondu hostitelů

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-TenantName

Název tenanta.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ValidationEnv

Logická hodnota označující, zda má být fond hostitelů považován za ověřovací fond hostitelů. Fondy hostitelů pro ověření přijímají aktualizace služeb rychleji než fondy hostitelů bez ověření, což vám umožňuje testovat změny služeb před jejich širokým nasazením do produkčního prostředí.

Vlastnosti parametru

Typ:	String
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

System.String

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool