New-AzWvdHostPool
Crie ou atualize um pool de hosts.
Syntax
New-AzWvdHostPool
-Name <String>
-ResourceGroupName <String>
-HostPoolType <HostPoolType>
-LoadBalancerType <LoadBalancerType>
-PreferredAppGroupType <PreferredAppGroupType>
[-Location <String>]
[-SubscriptionId <String>]
[-AgentUpdateMaintenanceWindow <IMaintenanceWindowProperties[]>]
[-AgentUpdateMaintenanceWindowTimeZone <String>]
[-AgentUpdateType <SessionHostComponentUpdateType>]
[-AgentUpdateUseSessionHostLocalTime]
[-CustomRdpProperty <String>]
[-Description <String>]
[-ExpirationTime <DateTime>]
[-FriendlyName <String>]
[-IdentityType <ResourceIdentityType>]
[-Kind <String>]
[-ManagedBy <String>]
[-MaxSessionLimit <Int32>]
[-PersonalDesktopAssignmentType <PersonalDesktopAssignmentType>]
[-PlanName <String>]
[-PlanProduct <String>]
[-PlanPromotionCode <String>]
[-PlanPublisher <String>]
[-PlanVersion <String>]
[-PublicNetworkAccess <HostpoolPublicNetworkAccess>]
[-RegistrationInfoToken <String>]
[-RegistrationTokenOperation <RegistrationTokenOperation>]
[-Ring <Int32>]
[-SkuCapacity <Int32>]
[-SkuFamily <String>]
[-SkuName <String>]
[-SkuSize <String>]
[-SkuTier <SkuTier>]
[-SsoClientId <String>]
[-SsoClientSecretKeyVaultPath <String>]
[-SsoSecretType <SsoSecretType>]
[-SsoadfsAuthority <String>]
[-StartVMOnConnect]
[-Tag <Hashtable>]
[-VMTemplate <String>]
[-ValidationEnvironment]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzWvdHostPool
-Name <String>
-ResourceGroupName <String>
-HostPoolType <HostPoolType>
-LoadBalancerType <LoadBalancerType>
-PreferredAppGroupType <PreferredAppGroupType>
[-Location <String>]
[-SubscriptionId <String>]
[-DesktopAppGroupName <String>]
[-WorkspaceName <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Crie ou atualize um pool de hosts.
Exemplos
Exemplo 1: Criar um Windows Virtual Desktop HostPool 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
Este comando cria um Windows Virtual Desktop HostPool em um Grupo de Recursos.
Exemplo 2: Criar um Windows Virtual Desktop HostPool 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
Este comando cria um Windows Virtual Desktop HostPool em um Grupo de Recursos.
Parâmetros
-AgentUpdateMaintenanceWindow
Lista de janelas de manutenção. As janelas de manutenção têm 2 horas de duração. Para construir, consulte a seção NOTAS para propriedades AGENTUPDATEMAINTENANCEWINDOW e crie uma tabela de hash.
Type: | IMaintenanceWindowProperties[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentUpdateMaintenanceWindowTimeZone
Fuso horário para manutenção, conforme definido em https://learn.microsoft.com/dotnet/api/system.timezoneinfo.findsystemtimezonebyid. Deve ser definido se useLocalTime for true.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentUpdateType
O tipo de manutenção para componentes de host de sessão.
Type: | SessionHostComponentUpdateType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentUpdateUseSessionHostLocalTime
Se deve usar localTime da máquina virtual.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomRdpProperty
Propriedade rdp personalizada de HostPool.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Descrição de HostPool.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DesktopAppGroupName
Nome do Grupo de Aplicações de Ambiente de Trabalho
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpirationTime
Tempo de expiração do token de registro.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FriendlyName
Nome amigável de HostPool.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostPoolType
Tipo de HostPool para área de trabalho.
Type: | HostPoolType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdentityType
O tipo de identidade.
Type: | ResourceIdentityType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Kind
Metadados usados pelo portal/ferramenta/etc para renderizar diferentes experiências de UX 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LoadBalancerType
O tipo do balanceador de carga.
Type: | LoadBalancerType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
A geolocalização onde o recurso vive
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 em modo completo não excluirá o recurso se ele for removido do modelo, uma vez que é gerenciado por outro recurso.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSessionLimit
O limite máximo de sessão do HostPool.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
O nome do pool de hosts dentro do grupo de recursos especificado
Type: | String |
Aliases: | HostPoolName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersonalDesktopAssignmentType
Tipo PersonalDesktopAssignment para HostPool.
Type: | PersonalDesktopAssignmentType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanName
Um nome definido pelo usuário do artefato de 3ª parte que está sendo adquirido.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanProduct
O artefato da 3ª Parte que está sendo adquirido. Por exemplo, NewRelic. O produto é mapeado para o OfferID especificado para o artefato no momento da integração do Data Market.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanPromotionCode
Um editor forneceu o código promocional conforme previsto no Data Market para o referido produto/artefato.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanPublisher
O editor do 3rd Party Artifact que está sendo comprado. Por exemplo, NewRelic
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanVersion
A versão do produto/artefato desejado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredAppGroupType
O tipo de grupo de aplicativos preferido, padrão para Grupo de Aplicativos de Área de Trabalho
Type: | PreferredAppGroupType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicNetworkAccess
Ativado permite que este recurso seja acedido a partir de redes públicas e privadas, Desativado permite que este recurso só seja acedido através de terminais privados
Type: | HostpoolPublicNetworkAccess |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistrationInfoToken
A cadeia de caracteres codificada base64 do token de registro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistrationTokenOperation
O tipo de redefinição do token.
Type: | RegistrationTokenOperation |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Ring
O número do anel de HostPool.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuCapacity
Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuFamily
Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuName
O nome do SKU. Ex - P3. Normalmente, é um código de letra + número
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuSize
O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, este seria o código autônomo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuTier
Este campo deve ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não é obrigatório em um PUT.
Type: | SkuTier |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SsoadfsAuthority
URL para o servidor ADFS do cliente para assinar certificados SSO WVD.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SsoClientId
ClientId para a Terceira Parte Confiável registrada usada para emitir certificados SSO WVD.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SsoClientSecretKeyVaultPath
Caminho para o Azure KeyVault armazenando o segredo usado para comunicação com o ADFS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SsoSecretType
O tipo de sinal único no Tipo Secreto.
Type: | SsoSecretType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartVMOnConnect
O sinalizador para ativar/desativar o recurso StartVMOnConnect.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
A ID da assinatura de destino.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Tags de recursos.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidationEnvironment
É ambiente de validação.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMTemplate
Modelo de VM para configuração de hosts de sessão dentro do hostpool.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkspaceName
Nome da Área de Trabalho
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20231004Preview.IHostPool
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários