New-AzWvdHostPool

Sintaxis

CreateExpanded (valor predeterminado)

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -HostPoolType <String>
    -LoadBalancerType <String>
    -Location <String>
    -PreferredAppGroupType <String>
    [-SubscriptionId <String>]
    [-AgentUpdateMaintenanceWindow <IMaintenanceWindowProperties[]>]
    [-AgentUpdateMaintenanceWindowTimeZone <String>]
    [-AgentUpdateType <String>]
    [-AgentUpdateUseSessionHostLocalTime]
    [-CustomRdpProperty <String>]
    [-Description <String>]
    [-ExpirationTime <DateTime>]
    [-FriendlyName <String>]
    [-IdentityType <String>]
    [-Kind <String>]
    [-ManagedBy <String>]
    [-MaxSessionLimit <Int32>]
    [-PersonalDesktopAssignmentType <String>]
    [-PlanName <String>]
    [-PlanProduct <String>]
    [-PlanPromotionCode <String>]
    [-PlanPublisher <String>]
    [-PlanVersion <String>]
    [-PublicNetworkAccess <String>]
    [-RegistrationInfoToken <String>]
    [-RegistrationTokenOperation <String>]
    [-Ring <Int32>]
    [-SkuCapacity <Int32>]
    [-SkuFamily <String>]
    [-SkuName <String>]
    [-SkuSize <String>]
    [-SkuTier <String>]
    [-SsoClientId <String>]
    [-SsoClientSecretKeyVaultPath <String>]
    [-SsoSecretType <String>]
    [-SsoadfsAuthority <String>]
    [-StartVMOnConnect]
    [-Tag <Hashtable>]
    [-VMTemplate <String>]
    [-ValidationEnvironment]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullScenarioCreate

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -HostPoolType <String>
    -LoadBalancerType <String>
    -Location <String>
    -PreferredAppGroupType <String>
    [-SubscriptionId <String>]
    [-DesktopAppGroupName <String>]
    [-WorkspaceName <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Creación de un host de Windows Virtual DesktopPool por nombre

New-AzWvdHostPool -ResourceGroupName ResourceGroupName `
                            -Name HostPoolName `
                            -Location 'eastus' `
                            -HostPoolType 'Pooled' `
                            -LoadBalancerType 'DepthFirst' `
                            -RegistrationTokenOperation 'Update' `
                            -ExpirationTime $((Get-Date).ToUniversalTime().AddDays(1).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ')) `
                            -Description 'Description' `
                            -FriendlyName 'Friendly Name' `
                            -MaxSessionLimit 5 `
                            -VMTemplate $null `
                            -SsoClientId $null `
                            -SsoClientSecretKeyVaultPath $null `
                            -SsoSecretType $null `
                            -SsoadfsAuthority $null `
                            -CustomRdpProperty $null `
                            -Ring $null `
                            -ValidationEnvironment:$false

Location   Name                 Type
--------   ----                 ----
eastus     HostPoolName Microsoft.DesktopVirtualization/hostpools

Ejemplo 2: Creación de un hostpool de Windows Virtual Desktop por nombre

New-AzWvdHostPool -ResourceGroupName ResourceGroupName `
                            -Name HostPoolName `
                            -Location 'eastus' `
                            -HostPoolType 'Personal' `
                            -LoadBalancerType 'Persistent' `
                            -RegistrationTokenOperation 'Update' `
                            -ExpirationTime $((Get-Date).ToUniversalTime().AddDays(1).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ')) `
                            -Description 'Description' `
                            -FriendlyName 'Friendly Name' `
                            -MaxSessionLimit 5 `
                            -VMTemplate $null `
                            -SsoClientId $null `
                            -SsoClientSecretKeyVaultPath $null `
                            -SsoSecretType $null `
                            -SsoadfsAuthority $null `
                            -CustomRdpProperty $null `
                            -Ring $null `
                            -ValidationEnvironment:$false

Location   Name                 Type
--------   ----                 ----
eastus     HostPoolName Microsoft.DesktopVirtualization/hostpools

Parámetros

-AgentUpdateMaintenanceWindow

Lista de ventanas de mantenimiento. Las ventanas de mantenimiento tienen una duración de 2 horas.

Propiedades de parámetro

Conjuntos de parámetros

-AgentUpdateMaintenanceWindowTimeZone

Zona horaria para mantenimiento como se define en https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Debe establecerse si useLocalTime es true.

Propiedades de parámetro

Conjuntos de parámetros

-AgentUpdateType

Tipo de mantenimiento para los componentes del host de sesión.

Propiedades de parámetro

Conjuntos de parámetros

-AgentUpdateUseSessionHostLocalTime

Si se usa localTime de la máquina virtual.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-CustomRdpProperty

Propiedad rdp personalizada de HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Propiedades de parámetro

Conjuntos de parámetros

-Description

Descripción de HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-DesktopAppGroupName

Nombre del grupo de aplicaciones de escritorio

Propiedades de parámetro

Conjuntos de parámetros

-ExpirationTime

Hora de expiración del token de registro.

Propiedades de parámetro

Conjuntos de parámetros

-FriendlyName

Nombre descriptivo de HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-HostPoolType

Tipo hostPool para escritorio.

Propiedades de parámetro

Conjuntos de parámetros

-IdentityType

Tipo de identidad.

Propiedades de parámetro

Conjuntos de parámetros

-JsonFilePath

Ruta de acceso del archivo Json proporcionado a la operación Create

Propiedades de parámetro

Conjuntos de parámetros

-JsonString

Cadena JSON proporcionada a la operación Create

Propiedades de parámetro

Conjuntos de parámetros

-Kind

Metadatos usados por el portal, las herramientas, etc. para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo. Por ejemplo, ApiApps es un tipo de tipo Microsoft.Web/sites. Si se admite, el proveedor de recursos debe validar y conservar este valor.

Propiedades de parámetro

Conjuntos de parámetros

-LoadBalancerType

Tipo del equilibrador de carga.

Propiedades de parámetro

Conjuntos de parámetros

-Location

Ubicación geográfica donde reside el recurso

Propiedades de parámetro

Conjuntos de parámetros

-ManagedBy

Identificador de recurso completo del recurso que administra este recurso. Indica si otro recurso de Azure administra este recurso. Si está presente, la implementación del modo completo no eliminará el recurso si se quita de la plantilla, ya que otro recurso lo administra.

Propiedades de parámetro

Conjuntos de parámetros

-MaxSessionLimit

Límite máximo de sesión de HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-Name

El nombre del grupo de hosts dentro del grupo de recursos especificado

Propiedades de parámetro

Conjuntos de parámetros

-PersonalDesktopAssignmentType

Tipo PersonalDesktopAssignment para HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-PlanName

Nombre definido por el usuario del artefacto de terceros que se está adquierendo.

Propiedades de parámetro

Conjuntos de parámetros

-PlanProduct

Artefacto de terceros que se está adquierendo. Por ejemplo, NewRelic. El producto se asigna al offerID especificado para el artefacto en el momento de la incorporación de Data Market.

Propiedades de parámetro

Conjuntos de parámetros

-PlanPromotionCode

Un publicador proporcionó código de promoción tal como se aprovisionó en Data Market para dicho producto o artefacto.

Propiedades de parámetro

Conjuntos de parámetros

-PlanPublisher

Publicador del artefacto de terceros que se está comprando. Por ejemplo, NewRelic

Propiedades de parámetro

Conjuntos de parámetros

-PlanVersion

Versión del producto o artefacto deseado.

Propiedades de parámetro

Conjuntos de parámetros

-PreferredAppGroupType

El tipo de tipo de grupo de aplicaciones preferido, el valor predeterminado es Grupo de aplicaciones de escritorio.

Propiedades de parámetro

Conjuntos de parámetros

-PublicNetworkAccess

Habilitado permite que se acceda a este recurso desde redes públicas y privadas, Deshabilitado permite que solo se acceda a este recurso a través de puntos de conexión privados.

Propiedades de parámetro

Conjuntos de parámetros

-RegistrationInfoToken

Cadena codificada en base64 del token de registro.

Propiedades de parámetro

Conjuntos de parámetros

-RegistrationTokenOperation

Tipo de restablecimiento del token.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

Conjuntos de parámetros

-Ring

Número de anillo de HostPool.

Propiedades de parámetro

Conjuntos de parámetros

-SkuCapacity

Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.

Propiedades de parámetro

Conjuntos de parámetros

-SkuFamily

Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.

Propiedades de parámetro

Conjuntos de parámetros

-SkuName

Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número

Propiedades de parámetro

Conjuntos de parámetros

-SkuSize

Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.

Propiedades de parámetro

Conjuntos de parámetros

-SkuTier

El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.

Propiedades de parámetro

Conjuntos de parámetros

-SsoadfsAuthority

Dirección URL al servidor ADFS del cliente para firmar certificados SSO de WVD.

Propiedades de parámetro

Conjuntos de parámetros

-SsoClientId

ClientId para el usuario de confianza registrado usado para emitir certificados SSO de WVD.

Propiedades de parámetro

Conjuntos de parámetros

-SsoClientSecretKeyVaultPath

Ruta de acceso a Azure KeyVault que almacena el secreto usado para la comunicación con ADFS.

Propiedades de parámetro

Conjuntos de parámetros

-SsoSecretType

Tipo de inicio de sesión único en Tipo secreto.

Propiedades de parámetro

Conjuntos de parámetros

-StartVMOnConnect

Marca para activar o desactivar la característica StartVMOnConnect.

Propiedades de parámetro

Conjuntos de parámetros

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Propiedades de parámetro

Conjuntos de parámetros

-Tag

Etiquetas de recursos.

Propiedades de parámetro

Conjuntos de parámetros

-ValidationEnvironment

Es el entorno de validación.

Propiedades de parámetro

Conjuntos de parámetros

-VMTemplate

Plantilla de máquina virtual para la configuración de sessionhosts dentro del grupo de hosts.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

-WorkspaceName

Nombre del área de trabajo

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Salidas

IHostPool