Deploy-SimanAzWvdHost⚓︎

SYNOPSIS⚓︎

Actualiza la cantidad de VMs en un HostPool de Azure Virtual Desktop.

Importante

Se necesita el rol de Cloud Admin para ejecutar este comando.

SYNTAX⚓︎

Deploy-SimanAzWvdHost [[-HostPool] <string>] [-TotalInstances] <int> [[-Prefix] <string>]
 [[-VMSize] <string>] [[-OSVersion] <string>] [[-Region] <string>] [[-OverrideTemplate] <string>]
 [-Validate] [<CommonParameters>]

ALIASES⚓︎

Resize-SimanAzWvdHostPool

DESCRIPTION⚓︎

Provisiona en el HostPool especificado la cantidad total de instancias indicadas por el parámetro -TotalInstances correspondientes a un mismo prefijo.

El nombre del host se asigna en base a dicho prefijo más un consecutivo entre 1 y TotalInstances, considerando el valor por defecto del prefijo (azvd{hostpool}-{YYMM}) para mantener un pool de instancias consistente por HostPool al mes.

Si ya existieran instancias correspondientes al mes actual y se ejecuta nuevamente el comando, solo se crearían nuevas instancias si el valor de -TotalInstances es mayor a la cantidad actual.

Importante

Las instancias correspondientes a otros meses quedan intactas y solo se suman las del mes en curso, por lo que es necesario eliminar las anteriores como parte del mantenimiento de los hosts.

EXAMPLES⚓︎

Example 1 - Ejecuta el deployment en modo de validación⚓︎

PS> Deploy-SimanAzWvdHost -HostPool G8-PD -TotalInstances 15 -Validate

Example 2 - Ejecuta el deployment de manera definitiva⚓︎

PS> Deploy-SimanAzWvdHost -HostPool G8-QA -TotalInstances 12

Example 3 - Especificar un tamaño de VM personalizado⚓︎

PS> Deploy-SimanAzWvdHost -HostPool G8-PD -TotalInstances 8 -VMSize Standard_D2s_v3

PARAMETERS⚓︎

-HostPool⚓︎

Nombre del hostpool a provisionar.

Si no se especifica, aplica al pool de producción (G8-PD)

Type: System.String
DefaultValue: G8-PD
SupportsWildcards: false
Aliases:
- RDPool
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OSVersion⚓︎

Versión de Windows Server a utilizar para las instancias del HostPool.
Debe ser una versión válida de Windows Server soportada por Azure Virtual Desktop, como 2022 o 2025.

El valor por defecto es 2025.

Type: System.String
DefaultValue: 2025
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OverrideTemplate⚓︎

Con este parámetro es posible elegir el entorno del template que se utilizaría para el deployment.
Si no se especifica tomara el valor correspondiente al sufijo del HostPool al que se está provisionando.

Valores aceptados: PROD, QA

Type: System.String
DefaultValue: None
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 6
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues:
- PROD
- QA
HelpMessage: ''

-Prefix⚓︎

El prefijo con el que se definirá el nombre de cada instancia.
El nombre de la VM incluirá este prefijo más un consecutivo de 2 dígitos.

El valor proporcionado deberá ser una cadena entre 5 y 13 caracteres.

Type: System.String
DefaultValue: azvd{hostpool}-{YYMM}
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Region⚓︎

Type: System.String
DefaultValue: eastus
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-TotalInstances⚓︎

Cantidad total de instancias que se desea tener con el prefijo especificado.

Si el valor especificado es menor que la cantidad actual de instancias con dicho prefijo, el comando no realizará ningún cambio. Consulta la descripción para más detalles.

Este comando solo permite aumentar el número de instancias, no reducirlo. El rango permitido es entre 1 y 25 instancias.

Type: System.Int32
DefaultValue: 0
SupportsWildcards: false
Aliases:
- Qty
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Validate⚓︎

Ejecuta el deployment en modo de validación.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- WhatIf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VMSize⚓︎

Tamaño de la máquina virtual (SKU) a utilizar para las instancias del HostPool.

El valor por defecto es Standard_B2ms. Debe ser un tamaño válido de Azure VM.

Type: System.String
DefaultValue: Standard_B2ms
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters⚓︎

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS⚓︎

None⚓︎

OUTPUTS⚓︎

Siman.Cloud.Azure.VirtualDesktop⚓︎

Objeto personalizado con la información de las máquinas virtuales provisionadas en el hostpool.

NOTES⚓︎

Los templates utilizados por este comando corresponden a ARM template specs con la definición actual del provisionamiento de recursos.

Estos se encuentran dentro de la suscripción de Azure SIMAN (siman.cloud) - CSP en el Resource Group templateSpecs o templateSpecs-QA segun corresponda.