Set-RdsHostPool

Módulo:
Microsoft.RDInfra.RDPowershell Module

Establece las propiedades de un grupo de hosts.

Sintaxis

HP4 (Es el valor predeterminado). 

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

El cmdlet Set-RdsHostPool establece las propiedades del grupo de hosts especificado. Existen tres conjuntos de parámetros para este cmdlet. El primero se utiliza para deshabilitar los discos de perfil de usuario. El segundo se utiliza para habilitar los discos de perfil de usuario. El tercero se utiliza para establecer todas las demás propiedades del grupo de hosts.

Ejemplos

Ejemplo 1: Establecer el grupo de hosts para que use el equilibrio de carga en profundidad

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 establece el grupo de hosts para que use el equilibrio de carga en profundidad, de modo que todos los usuarios entrantes se dirigirán a un host de sesión específico hasta que alcance MaxSessionLimit, que se especifica como 10 en este ejemplo. El parámetro MaxSessionLimit es un requisito al establecer el equilibrio de carga en profundidad, ya que las conexiones no se distribuirán a los hosts de sesión posteriores hasta que se alcance este límite de sesión en el primer host de sesión.

Ejemplo 2: Establecer el grupo de hosts para que use el equilibrio de carga primero de amplitud

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 establece el grupo de hosts para que utilice el equilibrio de carga que da prioridad a la amplitud, de modo que los usuarios entrantes se dirijan uniformemente a través de los hosts de sesión del grupo de hosts. El parámetro MaxSessionLimit es opcional, ya que el equilibrio de carga en el modo de amplitud primero es menos restrictivo que el equilibrio de carga en el modo de profundidad primero.

Ejemplo 3: Establecer el grupo de hosts para que se trate como un entorno de validación

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 establece el grupo de hosts para que sea un grupo de hosts de validación. El grupo de hosts de validación recibirá actualizaciones de servicio con una cadencia más rápida, lo que le permitirá probar cualquier cambio de servicio antes de que se implemente ampliamente en producción.

Ejemplo 4: Establecer el grupo de hosts para usar la asignación directa

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 establece el grupo de hosts para usar la asignación directa para determinar el host de sesión de escritorio personal que se va a asignar al usuario. Con la asignación directa, el usuario debe estar asignado a un host de sesión antes de conectarse al grupo de hosts.

Ejemplo 5: Establecer el grupo de hosts para que utilice la asignación 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 establece el grupo de hosts para que utilice la asignación automática para determinar el host de sesión de escritorio personal que se va a asignar al usuario. Con la asignación automática, no es necesario que el usuario esté asignado a un host de sesión antes de conectarse al grupo de hosts.

Ejemplo 4: Establecer el grupo de hosts para usar la asignación directa

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 establece el grupo de hosts para usar la asignación directa para determinar el host de sesión de escritorio personal que se va a asignar al usuario. Con la asignación directa, el usuario debe estar asignado a un host de sesión antes de conectarse al grupo de hosts.

Ejemplo 5: Establecer el grupo de hosts para que utilice la asignación 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 establece el grupo de hosts para que utilice la asignación automática para determinar el host de sesión de escritorio personal que se va a asignar al usuario. Con la asignación automática, no es necesario que el usuario esté asignado a un host de sesión antes de conectarse al grupo de hosts.

Parámetros

-AssignmentType

El tipo de asignación para el grupo de hosts de escritorio personal:

  • Automático, lo que significa que a los usuarios se les asignará automáticamente un host de sesión en su primera conexión al grupo de hosts.
  • Directo, lo que significa que los usuarios deben estar asignados directamente a un host de sesión en el grupo para poder conectarse.

Propiedades del parámetro

Tipo:PersonalDesktopAssignmentType
Valor predeterminado:None
Valores aceptados:Automatic, Direct
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BreadthFirstLoadBalancer

Cambie para habilitar el uso del equilibrio de carga de amplitud primero para el grupo de hosts. La amplitud primero indica que las nuevas sesiones de usuario se dirigen al host de sesión con el menor número de sesiones de usuario.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP5
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CustomRdpProperty

Especifica la configuración del Protocolo de escritorio remoto (RDP) que se va a incluir en los archivos .rdp de todos los programas de RemoteApp y escritorios remotos publicados en esta colección. Consulte la configuración de archivos RDP de Escritorio remoto compatible para obtener más información.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP3
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DepthFirstLoadBalancer

Conmutador para habilitar el uso del equilibrio de carga en profundidad para el grupo de hosts. La profundidad primero indica que las nuevas sesiones de usuario se dirigen al host de sesión con el mayor número de sesiones de usuario que aún no ha alcanzado su límite máximo de sesiones.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP6
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Descripción del grupo de hosts.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP4
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FriendlyName

Nombre descriptivo del grupo de hosts que se va a mostrar.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP4
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaxSessionLimit

El número máximo de sesiones permitidas por host de sesión en el grupo de hosts. Cuando se establece el modo de profundidad primero para el equilibrio de carga, este valor se usa para determinar cuándo detener el equilibrio de carga de los usuarios en un host y comenzar a enviar usuarios al siguiente host.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

HP4
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
HP5
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre del grupo de hosts.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:HostPoolName

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-TenantName

El nombre del inquilino.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ValidationEnv

Valor booleano que indica si el grupo de hosts debe tratarse como un grupo de hosts de validación. Los grupos de hosts de validación reciben actualizaciones de servicio a una cadencia más rápida que los grupos de hosts que no son de validación, lo que le permite probar los cambios en el servicio antes de que se implementen ampliamente en producción.

Propiedades del parámetro

Tipo:String
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.String

Salidas

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool