Share via


az devcenter admin network-connection

Nota

Essa referência faz parte da extensão devcenter para a CLI do Azure (versão 2.51.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az devcenter admin network-connection . Saiba mais sobre extensões.

Gerencie conexões de rede.

Comandos

Name Description Tipo Estado
az devcenter admin network-connection create

Crie uma conexão de rede.

Extensão GA
az devcenter admin network-connection delete

Exclua uma conexão de rede.

Extensão GA
az devcenter admin network-connection list

Listar conexões de rede.

Extensão GA
az devcenter admin network-connection list-health-check

Listar detalhes do status da verificação de integridade.

Extensão GA
az devcenter admin network-connection list-outbound-network-dependencies-endpoint

Liste os pontos de extremidade que os agentes podem chamar como parte da administração do serviço Dev Box. Esses FQDNs devem ter permissão para acesso de saída para que o serviço Dev Box funcione.

Extensão GA
az devcenter admin network-connection run-health-check

Aciona uma nova execução de verificação de integridade. O resultado da execução e da verificação de integridade pode ser rastreado através dos detalhes da verificação de integridade da conexão de rede.

Extensão GA
az devcenter admin network-connection show

Obtenha uma conexão de rede.

Extensão GA
az devcenter admin network-connection show-health-check

Obtenha detalhes do status da verificação de integridade.

Extensão GA
az devcenter admin network-connection update

Atualize uma conexão de rede.

Extensão GA
az devcenter admin network-connection wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão GA

az devcenter admin network-connection create

Crie uma conexão de rede.

az devcenter admin network-connection create --domain-join-type {AzureADJoin, HybridAzureADJoin, None}
                                             --name
                                             --resource-group
                                             --subnet-id
                                             [--domain-name]
                                             [--domain-password]
                                             [--domain-username]
                                             [--location]
                                             [--networking-resource-group-name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--organization-unit]
                                             [--tags]

Exemplos

Criar associação híbrida

az devcenter admin network-connection create --location "eastus" --domain-join-type "HybridAzureADJoin" --domain-name "mydomaincontroller.local" --domain-password "Password value for user" --domain-username "testuser@mydomaincontroller.local" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default" --name "uswest3network" --resource-group "rg1"

Criar ingresso no Azure AD

az devcenter admin network-connection create --location "eastus" --domain-join-type "AzureADJoin" --networking-resource-group-name "NetworkInterfacesRG" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default" --name "uswest3network" --resource-group "rg1"

Parâmetros Obrigatórios

--domain-join-type

Tipo de junção do AAD.

valores aceites: AzureADJoin, HybridAzureADJoin, None
--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

--subnet-id

A sub-rede à qual anexar caixas de desenvolvimento.

Parâmetros Opcionais

--domain-name

Nome de domínio do Ative Directory.

--domain-password

A senha da conta usada para ingressar no domínio. Se o valor estiver em branco, é solicitado ao tty.

--domain-username

O nome de usuário de uma conta do Ative Directory (conta de usuário ou de serviço) que tem permissões para criar objetos de computador no Ative Directory. Formato exigido: admin@contoso.com.

--location -l

A geolocalização onde o recurso vive. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>. Quando não especificado, o local do grupo de recursos será usado.

--networking-resource-group-name -r

O nome do grupo de recursos onde as NICs serão colocadas.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--organization-unit

Unidade Organizacional (UO) do domínio Ative Directory.

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection delete

Exclua uma conexão de rede.

az devcenter admin network-connection delete [--ids]
                                             [--name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]
                                             [--yes]

Exemplos

Delete

az devcenter admin network-connection delete --name "uswest3network" --resource-group "rg1"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection list

Listar conexões de rede.

az devcenter admin network-connection list [--max-items]
                                           [--next-token]
                                           [--resource-group]

Exemplos

Lista por grupo de recursos

az devcenter admin network-connection list --resource-group "rg1"

Lista por subscrição

az devcenter admin network-connection list

Parâmetros Opcionais

--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 no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection list-health-check

Listar detalhes do status da verificação de integridade.

az devcenter admin network-connection list-health-check --name
                                                        --resource-group
                                                        [--max-items]
                                                        [--next-token]

Exemplos

Listar detalhes do status da verificação de integridade

az devcenter admin network-connection list-health-check --name "uswest3network" --resource-group "rg1"

Parâmetros Obrigatórios

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

Parâmetros Opcionais

--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 no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection list-outbound-network-dependencies-endpoint

Liste os pontos de extremidade que os agentes podem chamar como parte da administração do serviço Dev Box. Esses FQDNs devem ter permissão para acesso de saída para que o serviço Dev Box funcione.

az devcenter admin network-connection list-outbound-network-dependencies-endpoint --name
                                                                                  --resource-group
                                                                                  [--max-items]
                                                                                  [--next-token]

Exemplos

Listar pontos de extremidade de dependências de rede de saída

az devcenter admin network-connection list-outbound-network-dependencies-endpoint --name "uswest3network" --resource-group "rg1"

Parâmetros Obrigatórios

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

Parâmetros Opcionais

--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 no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection run-health-check

Aciona uma nova execução de verificação de integridade. O resultado da execução e da verificação de integridade pode ser rastreado através dos detalhes da verificação de integridade da conexão de rede.

az devcenter admin network-connection run-health-check [--ids]
                                                       [--name]
                                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                       [--resource-group]
                                                       [--subscription]

Exemplos

Executar verificação de integridade

az devcenter admin network-connection run-health-check --name "uswest3network" --resource-group "rg1"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection show

Obtenha uma conexão de rede.

az devcenter admin network-connection show [--ids]
                                           [--name]
                                           [--resource-group]
                                           [--subscription]

Exemplos

Get

az devcenter admin network-connection show --name "uswest3network" --resource-group "rg1"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection show-health-check

Obtenha detalhes do status da verificação de integridade.

az devcenter admin network-connection show-health-check [--ids]
                                                        [--name]
                                                        [--resource-group]
                                                        [--subscription]

Exemplos

Obter verificação de saúde

az devcenter admin network-connection show-health-check--name "uswest3network" --resource-group "rg1"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection update

Atualize uma conexão de rede.

az devcenter admin network-connection update [--domain-name]
                                             [--domain-password]
                                             [--domain-username]
                                             [--ids]
                                             [--name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--organization-unit]
                                             [--resource-group]
                                             [--subnet-id]
                                             [--subscription]
                                             [--tags]

Exemplos

Atualizar

az devcenter admin network-connection update --domain-password "New Password value for user" --name "networkConnection" --resource-group "rg1"

Parâmetros Opcionais

--domain-name

Nome de domínio do Ative Directory.

--domain-password

A palavra-passe da conta utilizada para aderir ao domínio Se o valor estiver em branco, é pedida ao tty.

--domain-username

O nome de usuário de uma conta do Ative Directory (conta de usuário ou de serviço) que tem permissões para criar objetos de computador no Ative Directory. Formato exigido: admin@contoso.com.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --network-connection-name -n

Nome da Conexão de Rede que pode ser aplicada a um Pool.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--organization-unit

Unidade Organizacional (UO) do domínio Ative Directory.

--resource-group -g

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

--subnet-id

A sub-rede à qual anexar Máquinas Virtuais.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az devcenter admin network-connection wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az devcenter admin network-connection wait [--created]
                                           [--custom]
                                           [--deleted]
                                           [--exists]
                                           [--ids]
                                           [--interval]
                                           [--name]
                                           [--resource-group]
                                           [--subscription]
                                           [--timeout]
                                           [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--name --network-connection-name -n

Nome da conexão de rede que pode ser aplicada a um pool.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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