New-RdsHostPool
Crea un grupo de hosts.
Sintaxis
Default (Es el valor predeterminado).
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>]
Description
Crea un grupo de hosts dentro de un inquilino. El grupo de hosts contiene uno o varios hosts de sesión a los que los usuarios pueden conectarse para ejecutar programas, guardar archivos y utilizar recursos en esos hosts.
En el momento de la creación, puede decidir crear un grupo de hosts persistentes mediante la marca persistente. Al crear un grupo de hosts persistentes, el usuario siempre se conectará al mismo host de sesión para sus sesiones. Si no utiliza esta marca, se crea un grupo de hosts agrupados. En un grupo de hosts agrupados, los usuarios se conectan a un host de sesión en el grupo seleccionado dinámicamente por el equilibrador de carga.
Ejemplos
Ejemplo 1: Creación de un grupo de hosts agrupados
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoHostPool"
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoHostPool
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : BreadthFirst
ValidationEnv : False
Ring :
AssignmentType :
Este comando crea un nuevo grupo de hosts agrupados en el inquilino especificado. El grupo de hosts se rellena con algunos valores predefinidos. Para cambiar estos valores, ejecute el cmdlet Set-RdsHostPool.
Ejemplo 2: Creación de un grupo de hosts de escritorio personal
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoPersonal" -Persistent
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoPersonal
FriendlyName :
Description :
Persistent : True
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : False
Ring :
AssignmentType : Automatic
Este comando crea un nuevo grupo de hosts de escritorio personal en el inquilino especificado. Si no proporciona el tipo de asignación al ejecutar el comando, el grupo de hosts de escritorio personal se establecerá en asignación automática. Para cambiar el tipo de asignación o cualquier otra propiedad del grupo de hosts, ejecute el cmdlet Set-RdsHostPool.
Ejemplo 3: Creación de un grupo de hosts de validación
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoValidation" -ValidationEnv $true
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoValidation
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : True
Ring :
AssignmentType : Automatic
Este comando crea un nuevo grupo de hosts de validación agrupado en el inquilino especificado. 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. Para cambiar el grupo de hosts para que ya no sea un grupo de hosts de validación, ejecute el cmdlet Set-RdsHostPool.
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 |
-Description
Una cadena de 512 caracteres que describe el HostPool para ayudar a los administradores. Se permite cualquier carácter.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| 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 |
-FriendlyName
Cadena de 256 caracteres diseñada para mostrar a los usuarios finales. Se permite cualquier carácter.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| 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 |
-Name
Nombre del grupo de hosts, que debe ser único en el inquilino.
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 |
-Persistent
Un modificador que indica que se marque el grupo de hosts como persistente.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| 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 |
-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.