Set-RdsHostPool

  • Referência
Módulo:
WindowsVirtualDesktopPowershell

Define as propriedades para uma piscina de anfitriões.

Syntax

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

O Set-RdsHostPool cmdlet define as propriedades para a piscina de anfitriões especificada. Existem três parâmetros para este cmdlet. Em primeiro lugar é usado para desativar os discos de perfil do utilizador. A segunda é usada para ativar discos de perfil do utilizador. O terceiro é usado para definir todas as outras propriedades da piscina hospedeira.

Exemplos

Exemplo 1: Definir a piscina hospedeira para utilizar o equilíbrio de carga de profundidade primeiro

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        :

Este comando define o pool anfitrião para utilizar o equilíbrio de carga de profundidade primeiro, de modo que os utilizadores que entram ser todos direcionados para um anfitrião de sessão específico até chegar ao MaxSessionLimit, que é especificado como 10 neste exemplo. O parâmetro MaxSessionLimit é um requisito para definir o equilíbrio de carga de profundidade primeiro, uma vez que as ligações não serão distribuídas aos anfitriões de sessão subsequentes até que este limite de sessão seja atingido no anfitrião da primeira sessão.

Exemplo 2: Definir a piscina hospedeira para utilizar o equilíbrio de carga de primeira largura

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        :

Este comando define a piscina hospedeira para utilizar o equilíbrio de carga de primeira largura, de modo que os utilizadores que entram ser igualmente direcionados através dos anfitriões da sessão na piscina de anfitriões. O parâmetro MaxSessionLimit é opcional, uma vez que o equilíbrio de carga no modo de primeira largura é menos restritivo do que o equilíbrio de carga no modo de profundidade primeiro.

Exemplo 3: Definir a piscina de anfitriões para ser tratada como um ambiente de validação

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        :

Este comando define a piscina anfitriã como uma piscina de anfitriões de validação. O pool de anfitriões de validação receberá atualizações de serviço a uma cadência mais rápida, permitindo-lhe testar quaisquer alterações de serviço antes de serem implantadas amplamente na produção.

Exemplo 4: Definir a piscina de anfitrião para utilizar a atribuição direta

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

Este comando define o pool anfitrião para utilizar a atribuição direta para determinar o anfitrião da sessão de ambiente de trabalho pessoal para atribuir o utilizador. Com a atribuição direta, o utilizador deve ser designado para um anfitrião de sessão antes de se ligar à piscina anfitriã.

Exemplo 5: Definir a piscina de anfitrião para utilizar a atribuição automática

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

Este comando define o pool anfitrião para utilizar a atribuição automática para determinar o anfitrião de sessão de ambiente de trabalho pessoal para atribuir o utilizador. Com a atribuição automática, o utilizador não precisa de ser designado para um anfitrião de sessão antes de se ligar à piscina anfitriã.

Exemplo 4: Definir a piscina de anfitrião para utilizar a atribuição direta

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

Este comando define o pool anfitrião para utilizar a atribuição direta para determinar o anfitrião da sessão de ambiente de trabalho pessoal para atribuir o utilizador. Com a atribuição direta, o utilizador deve ser designado para um anfitrião de sessão antes de se ligar à piscina anfitriã.

Exemplo 5: Definir a piscina de anfitrião para utilizar a atribuição automática

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

Este comando define o pool anfitrião para utilizar a atribuição automática para determinar o anfitrião de sessão de ambiente de trabalho pessoal para atribuir o utilizador. Com a atribuição automática, o utilizador não precisa de ser designado para um anfitrião de sessão antes de se ligar à piscina anfitriã.

Parâmetros

-AssignmentType

O tipo de atribuição para a piscina de anfitriões de ambiente de trabalho pessoal:

  • Automático, o que significa que os utilizadores serão automaticamente designados um anfitrião de sessão na sua primeira ligação à piscina anfitriã.
  • Direto, o que significa que os utilizadores devem ser diretamente designados para um anfitrião de sessão na piscina antes de poderem se conectar.
Type:PersonalDesktopAssignmentType
Accepted values:Automatic, Direct
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BreadthFirstLoadBalancer

Alterte para ativar a utilização de um equilíbrio de primeira carga para a piscina hospedeira. A amplitude indica que as novas sessões de utilizador são direcionadas para o anfitrião da sessão com o menor número de sessões de utilizadores.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomRdpProperty

Especifica as definições do Protocolo de Ambiente de Trabalho Remoto (RDP) para incluir nos ficheiros .rdp para todos os programas RemoteApp e desktops remotos publicados nesta coleção. Consulte as definições de ficheiros RDP de ambiente de trabalho remoto suportados para obter mais informações.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DepthFirstLoadBalancer

Comutador para permitir a utilização de um equilíbrio de carga de profundidade primeiro para a piscina hospedeira. O Deep-first indica que as novas sessões de utilizador são direcionadas para o anfitrião da sessão com o maior número de sessões de utilizadores que ainda não atingiram o limite máximo de sessão.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

A descrição da piscina anfitriã.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FriendlyName

O nome amigável da piscina anfitriã a exibir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSessionLimit

O número máximo de sessões permitidas por sessão na piscina anfitriã. Quando o modo de profundidade é definido para o equilíbrio de carga, este valor é usado para determinar quando parar a carga equilibrando os utilizadores para um hospedeiro e para começar a enviar os utilizadores para o próximo anfitrião.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

O nome da piscina anfitriã.

Type:String
Aliases:HostPoolName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantName

O nome do inquilino.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ValidationEnv

Um booleano indicando se a piscina de anfitrião deve ser tratada como uma piscina de anfitrião de validação. Os pools de anfitriões de validação recebem atualizações de serviços com uma cadência mais rápida do que as piscinas hospedeiras de não validação, permitindo-lhe testar alterações de serviço antes de serem implantadas amplamente na produção.

Type:String
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

System.String

Saídas

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool