az desktopvirtualization hostpool

Note

Essa referência faz parte da extensão desktopvirtualization para a CLI do Azure (versão 2.55.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az desktopvirtualization hostpool. Saiba mais sobre extensões.

Gerenciar o pool de host de virtualização da área de trabalho.

Comandos

Nome	Description	Tipo	Status
az desktopvirtualization hostpool create	Criar um pool de host.	Extension	GA
az desktopvirtualization hostpool delete	Excluir um pool de hosts.	Extension	GA
az desktopvirtualization hostpool list	Listar pools de hosts.	Extension	GA
az desktopvirtualization hostpool retrieve-registration-token	Token de registro do pool de hosts.	Extension	GA
az desktopvirtualization hostpool show	Mostrar um pool de hosts.	Extension	GA
az desktopvirtualization hostpool update	Atualize um pool de hosts.	Extension	GA

az desktopvirtualization hostpool create

Criar um pool de host.

az desktopvirtualization hostpool create --host-pool-type {BYODesktop, Personal, Pooled}
                                         --load-balancer-type {BreadthFirst, DepthFirst, Persistent}
                                         --name
                                         --preferred-app-group-type {Desktop, None, RailApplications}
                                         --resource-group
                                         [--custom-rdp-property]
                                         [--description]
                                         [--friendly-name]
                                         [--location]
                                         [--max-session-limit]
                                         [--personal-desktop-assignment-type {Automatic, Direct}]
                                         [--registration-info]
                                         [--ring]
                                         [--sso-client-id]
                                         [--sso-client-secret-key-vault-path]
                                         [--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
                                         [--ssoadfs-authority]
                                         [--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--tags]
                                         [--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--vm-template]

Exemplos

Criar pool de host

az desktopvirtualization hostpool create -g rg -n hostpool-name --friendly-name friendly --host-pool-type Pooled --load-balancer-type BreadthFirst --max-session-limit 999999 --personal-desktop-assignment-type Automatic --preferred-app-group-type Desktop --registration-info expiration-time="yyyy-mm-ddT08:38:08.189Z" registration-token-operation=Update --sso-client-id client --sso-client-secret-key-vault-path https://keyvault/secret --sso-secret-type SharedKey --start-vm-on-connect false

Parâmetros Exigidos

--host-pool-type

Tipo de pool de host para área de trabalho.

Propriedade	Valor
Valores aceitos:	BYODesktop, Personal, Pooled

--load-balancer-type

O tipo do balanceador de carga.

Propriedade	Valor
Valores aceitos:	BreadthFirst, DepthFirst, Persistent

--name -n

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

--preferred-app-group-type -t

O tipo de tipo de grupo de aplicativos preferencial, padrão para o grupo de aplicativos da área de trabalho.

Propriedade	Valor
Valores aceitos:	Desktop, None, RailApplications

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--custom-rdp-property

Propriedade rdp personalizada do pool de hosts.

--description

Descrição do HostPool.

--friendly-name

Nome amigável de HostPool.

--location -l

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

--max-session-limit

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

--personal-desktop-assignment-type

Tipo PersonalDesktopAssignment para HostPool.

Propriedade	Valor
Valores aceitos:	Automatic, Direct

--registration-info

As informações de registro do HostPool. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--ring

O número do anel de HostPool.

--sso-client-id

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

--sso-client-secret-key-vault-path -p

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

--sso-secret-type

O tipo de logon único no Tipo Secreto.

Propriedade	Valor
Valores aceitos:	Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault

--ssoadfs-authority

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

--start-vm-on-connect

O sinalizador para ativar/desativar o recurso StartVMOnConnect.

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--tags

Tags de recursos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--validation-environment

É o ambiente de validação.

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--vm-template

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

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az desktopvirtualization hostpool delete

Excluir um pool de hosts.

az desktopvirtualization hostpool delete [--force {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--ids]
                                         [--name]
                                         [--resource-group]
                                         [--subscription]
                                         [--yes]

Exemplos

Excluir pool de hosts

az desktopvirtualization hostpool delete -g rg -n hostpool-name

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--force

Force o sinalizador a excluir sessionHost.

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--name -n

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az desktopvirtualization hostpool list

Listar pools de hosts.

az desktopvirtualization hostpool list [--max-items]
                                       [--next-token]
                                       [--resource-group]

Exemplos

Listar pool de hosts

az desktopvirtualization hostpool list -g rg

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade	Valor
Grupo de parâmetros:	Pagination Arguments

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade	Valor
Grupo de parâmetros:	Pagination Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az desktopvirtualization hostpool retrieve-registration-token

Token de registro do pool de hosts.

az desktopvirtualization hostpool retrieve-registration-token [--ids]
                                                              [--name]
                                                              [--resource-group]
                                                              [--subscription]

Exemplos

Token de registro do pool de hosts.

az desktopvirtualization hostpool retrieve-registration-token -n hostpool-name -g rg

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--name -n

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az desktopvirtualization hostpool show

Mostrar um pool de hosts.

az desktopvirtualization hostpool show [--ids]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]

Exemplos

Mostrar pool de host

az desktopvirtualization hostpool show -g rg -n hostpool-name

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--name -n

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az desktopvirtualization hostpool update

Atualize um pool de hosts.

az desktopvirtualization hostpool update [--add]
                                         [--custom-rdp-property]
                                         [--description]
                                         [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--friendly-name]
                                         [--ids]
                                         [--load-balancer-type {BreadthFirst, DepthFirst, Persistent}]
                                         [--max-session-limit]
                                         [--name]
                                         [--personal-desktop-assignment-type {Automatic, Direct}]
                                         [--preferred-app-group-type {Desktop, None, RailApplications}]
                                         [--registration-info]
                                         [--remove]
                                         [--resource-group]
                                         [--ring]
                                         [--set]
                                         [--sso-client-id]
                                         [--sso-client-secret-key-vault-path]
                                         [--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
                                         [--ssoadfs-authority]
                                         [--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--subscription]
                                         [--tags]
                                         [--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--vm-template]

Exemplos

Atualizar o pool de hosts

az desktopvirtualization hostpool update -g rg -n hostpool-name --tags tag=test

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments

--custom-rdp-property

Propriedade rdp personalizada do pool de hosts.

--description

Descrição do HostPool.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--friendly-name

Nome amigável de HostPool.

--ids

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--load-balancer-type

O tipo do balanceador de carga.

Propriedade	Valor
Valores aceitos:	BreadthFirst, DepthFirst, Persistent

--max-session-limit

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

--name -n

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--personal-desktop-assignment-type

Tipo PersonalDesktopAssignment para HostPool.

Propriedade	Valor
Valores aceitos:	Automatic, Direct

--preferred-app-group-type -t

O tipo de tipo de grupo de aplicativos preferencial, padrão para o grupo de aplicativos da área de trabalho.

Propriedade	Valor
Valores aceitos:	Desktop, None, RailApplications

--registration-info

As informações de registro do HostPool. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--ring

O número do anel de HostPool.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments

--sso-client-id

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

--sso-client-secret-key-vault-path -p

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

--sso-secret-type

O tipo de logon único no Tipo Secreto.

Propriedade	Valor
Valores aceitos:	Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault

--ssoadfs-authority

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

--start-vm-on-connect

O sinalizador para ativar/desativar o recurso StartVMOnConnect.

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--tags

Tags de recursos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--validation-environment

É o ambiente de validação.

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--vm-template

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

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az desktopvirtualization hostpool

Comandos

az desktopvirtualization hostpool create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az desktopvirtualization hostpool delete

Exemplos

Parâmetros Opcionais

az desktopvirtualization hostpool list

Exemplos

Parâmetros Opcionais

az desktopvirtualization hostpool retrieve-registration-token

Exemplos

Parâmetros Opcionais

az desktopvirtualization hostpool show

Exemplos

Parâmetros Opcionais

az desktopvirtualization hostpool update

Exemplos

Parâmetros Opcionais

Comentários