Set-RdsHostPool

Modul:

Microsoft.RDInfra.RDPowershell Module

Anger egenskaperna för en värdpool.

Syntax

HP4 (Standard)

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

Cmdleten Set-RdsHostPool anger egenskaperna för den angivna värdpoolen. Det finns tre parameteruppsättningar för den här cmdleten. First används för att inaktivera användarprofildiskar. Den andra används för att aktivera användarprofildiskar. Den tredje används för att ange alla andra egenskaper för värdpoolen.

Exempel

Exempel 1: Ställ in värdpoolen så att den använder belastningsutjämning med djup först

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        :

Det här kommandot anger att värdpoolen ska använda djup-först-belastningsutjämning, så att inkommande användare dirigeras till en specifik sessionsvärd tills den når MaxSessionLimit, som anges som 10 i det här exemplet. Parametern MaxSessionLimit är ett krav när du ställer in djup-först-belastningsutjämning eftersom anslutningar inte distribueras till efterföljande sessionsvärdar förrän den här sessionsgränsen har nåtts på den första sessionsvärden.

Exempel 2: Ställ in värdpoolen så att den använder bredd-först-belastningsutjämning

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        :

Det här kommandot anger att värdpoolen ska använda belastningsutjämning med bredd först, så att inkommande användare dirigeras jämnt mellan sessionsvärdar i värdpoolen. Parametern MaxSessionLimit är valfri eftersom belastningsutjämning i bredd-först-läge är mindre restriktiv än belastningsutjämning i djup-först-läge.

Exempel 3: Ange att värdpoolen ska behandlas som en valideringsmiljö

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        :

Det här kommandot anger att värdpoolen ska vara en valideringsvärdpool. Valideringsvärdpoolen tar emot tjänstuppdateringar snabbare, så att du kan testa eventuella tjänständringar innan de distribueras brett i produktion.

Exempel 4: Ange att värdpoolen ska använda direkttilldelning

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

Det här kommandot anger att värdpoolen ska använda direkttilldelning för att fastställa vilken värd för den personliga skrivbordssessionen som ska tilldela användaren. Med direkttilldelning måste användaren tilldelas en sessionsvärd innan han eller hon ansluter till värdpoolen.

Exempel 5: Ställ in värdpoolen så att den använder automatisk tilldelning

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

Det här kommandot anger att värdpoolen ska använda automatisk tilldelning för att bestämma vilken värd för den personliga skrivbordssessionen som ska tilldela användaren. Med automatisk tilldelning behöver användaren inte tilldelas en sessionsvärd innan han eller hon ansluter till värdpoolen.

Exempel 4: Ange att värdpoolen ska använda direkttilldelning

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

Det här kommandot anger att värdpoolen ska använda direkttilldelning för att fastställa vilken värd för den personliga skrivbordssessionen som ska tilldela användaren. Med direkttilldelning måste användaren tilldelas en sessionsvärd innan han eller hon ansluter till värdpoolen.

Exempel 5: Ställ in värdpoolen så att den använder automatisk tilldelning

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

Det här kommandot anger att värdpoolen ska använda automatisk tilldelning för att bestämma vilken värd för den personliga skrivbordssessionen som ska tilldela användaren. Med automatisk tilldelning behöver användaren inte tilldelas en sessionsvärd innan han eller hon ansluter till värdpoolen.

Parametrar

-AssignmentType

Tilldelningstypen för värdpoolen för det personliga skrivbordet:

• Automatisk, vilket innebär att användarna automatiskt tilldelas en sessionsvärd vid sin första anslutning till värdpoolen.
• Direkt, vilket innebär att användarna måste tilldelas direkt till en sessionsvärd i poolen innan de kan ansluta.

Parameteregenskaper

Typ:	PersonalDesktopAssignmentType
Standardvärde:	None
Godkända värden:	Automatic, Direct
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-BreadthFirstLoadBalancer

Växel för att aktivera användning av bredd-först-belastningsutjämning för värdpoolen. Bredden först anger att nya användarsessioner dirigeras till sessionsvärden med minst antal användarsessioner.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP5

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-CustomRdpProperty

Anger RDP-inställningar (Remote Desktop Protocol) som ska ingå i RDP-filerna för alla RemoteApp-program och fjärrskrivbord som publiceras i den här samlingen. Mer information finns i Inställningar för RDP-filer för fjärrskrivbord som stöds .

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP3

Position:	Named
Obligatorisk:	False
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-DepthFirstLoadBalancer

Växel för att aktivera användning av djup-först-belastningsutjämning för värdpoolen. Djup-först anger att nya användarsessioner dirigeras till sessionsvärden med det högsta antalet användarsessioner som inte redan har nått sin maximala sessionsgräns.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP6

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Description

Beskrivningen av värdpoolen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP4

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FriendlyName

Det egna namnet på värdpoolen som ska visas.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP4

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-MaxSessionLimit

Det maximala antalet sessioner som tillåts per sessionsvärd i värdpoolen. När djup-först-läget är inställt för belastningsutjämning används det här värdet för att avgöra när belastningsutjämning av användare ska stoppas till en värd och börja skicka användare till nästa värd.

Parameteregenskaper

Typ:	Int32
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

HP4

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

HP5

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

Namnet på värdpoolen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	HostPoolName (på engelska)

Parameteruppsättningar

(All)

Position:	1
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-TenantName

Namnet på hyresgästen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-ValidationEnv

Ett booleskt värde som anger om värdpoolen ska behandlas som en valideringsvärdpool. Valideringsvärdpooler tar emot tjänstuppdateringar i snabbare takt än icke-valideringsvärdpooler, vilket gör att du kan testa tjänständringar innan de distribueras brett till produktion.

Parameteregenskaper

Typ:	String
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool