New-AzWvdHostPool

Sintaxe

CreateExpanded (Default)

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

Exemplos

Exemplo 1: Criar um HostPool da Área de Trabalho Virtual do Windows por nome

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

Exemplo 2: Criar um HostPool da Área de Trabalho Virtual do Windows por nome

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 janelas de manutenção. As janelas de manutenção têm 2 horas de duração.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgentUpdateMaintenanceWindowTimeZone

Fuso horário para manutenção, conforme definido em https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Deve ser definido se useLocalTime for true.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgentUpdateType

O tipo de manutenção para componentes de host de sessão.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgentUpdateUseSessionHostLocalTime

Se deve usar localTime da máquina virtual.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-CustomRdpProperty

Propriedade rdp personalizada do HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades do parâmetro

Conjuntos de parâmetros

-Description

Descrição do HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-DesktopAppGroupName

Nome do Grupo de Aplicativos da Área de Trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

-ExpirationTime

Hora de expiração do token de registro.

Propriedades do parâmetro

Conjuntos de parâmetros

-FriendlyName

Nome amigável de HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-HostPoolType

Tipo de HostPool para área de trabalho.

Propriedades do parâmetro

Conjuntos de parâmetros

-IdentityType

O tipo de identidade.

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-Kind

Metadados usados pelo portal/ferramentas/etc para renderizar diferentes experiências de experiência de experiência de usuário para recursos do mesmo tipo. Por exemplo, ApiApps são um tipo de Microsoft.Web/sites. Se houver suporte, o provedor de recursos deverá validar e persistir esse valor.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerType

O tipo do balanceador de carga.

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

A localização geográfica onde o recurso reside

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedBy

A ID de recurso totalmente qualificada do recurso que gerencia esse recurso. Indica se esse recurso é gerenciado por outro recurso do Azure. Se isso estiver presente, a implantação do modo completo não excluirá o recurso se ele for removido do modelo, pois ele é gerenciado por outro recurso.

Propriedades do parâmetro

Conjuntos de parâmetros

-MaxSessionLimit

O limite máximo de sessão de HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

O nome do pool de host dentro do grupo de recursos especificado

Propriedades do parâmetro

Conjuntos de parâmetros

-PersonalDesktopAssignmentType

Tipo PersonalDesktopAssignment para HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-PlanName

Um nome definido pelo usuário do Artefato de terceiros que está sendo adquirido.

Propriedades do parâmetro

Conjuntos de parâmetros

-PlanProduct

O artefato de terceiros que está sendo adquirido. Por exemplo, NewRelic. O produto é mapeado para a OfferID especificada para o artefato no momento da integração do Mercado de Dados.

Propriedades do parâmetro

Conjuntos de parâmetros

-PlanPromotionCode

Um editor forneceu código de promoção como provisionado no Mercado de Dados para o produto/artefato.

Propriedades do parâmetro

Conjuntos de parâmetros

-PlanPublisher

O editor do Artefato de Terceiros que está sendo comprado. Por exemplo, NewRelic

Propriedades do parâmetro

Conjuntos de parâmetros

-PlanVersion

A versão do produto/artefato desejado.

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredAppGroupType

O tipo de tipo de grupo de aplicativos preferencial, padrão para o Grupo de Aplicativos da Área de Trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

-PublicNetworkAccess

Habilitado permite que esse recurso seja acessado de redes públicas e privadas, desabilitado permite que esse recurso seja acessado apenas por meio de pontos de extremidade privados

Propriedades do parâmetro

Conjuntos de parâmetros

-RegistrationInfoToken

A cadeia de caracteres codificada em base64 do token de registro.

Propriedades do parâmetro

Conjuntos de parâmetros

-RegistrationTokenOperation

O tipo de redefinição do token.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades do parâmetro

Conjuntos de parâmetros

-Ring

O número do anel de HostPool.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkuCapacity

Se o SKU der suporte à expansão/expansão, o inteiro de capacidade deverá ser incluído. Se a expansão/expansão não for possível para o recurso, isso poderá ser omitido.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkuFamily

Se o serviço tiver gerações diferentes de hardware, para o mesmo SKU, isso poderá ser capturado aqui.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkuName

O nome da SKU. Por exemplo, P3. Normalmente é um código de letra + número

Propriedades do parâmetro

Conjuntos de parâmetros

-SkuSize

O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkuTier

Esse campo deve ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.

Propriedades do parâmetro

Conjuntos de parâmetros

-SsoadfsAuthority

URL para o servidor ADFS do cliente para assinar certificados de SSO do WVD.

Propriedades do parâmetro

Conjuntos de parâmetros

-SsoClientId

ClientId para a Terceira Parte Confiável registrada usada para emitir certificados de SSO do WVD.

Propriedades do parâmetro

Conjuntos de parâmetros

-SsoClientSecretKeyVaultPath

Caminho para o Azure KeyVault armazenando o segredo usado para comunicação com o ADFS.

Propriedades do parâmetro

Conjuntos de parâmetros

-SsoSecretType

O tipo de logon único no Tipo Secreto.

Propriedades do parâmetro

Conjuntos de parâmetros

-StartVMOnConnect

O sinalizador para ativar/desativar o recurso StartVMOnConnect.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionId

A ID da assinatura de destino. O valor deve ser uma UUID.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Tags de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-ValidationEnvironment

É o ambiente de validação.

Propriedades do parâmetro

Conjuntos de parâmetros

-VMTemplate

Modelo de VM para configuração de sessionhosts no hostpool.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

-WorkspaceName

Nome do espaço de trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Saídas

IHostPool