Compartir a través de

az devcenter admin network-connection

  • Referencia

Nota

Esta referencia forma parte de la extensión de devcenter para la CLI de Azure (versión 2.67.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az devcenter admin network-connection. Más información sobre las extensiones.

Administrar conexiones de red.

Comandos

Nombre Description Tipo Estado
az devcenter admin network-connection create

Cree una conexión de red.

 Extensión GA
az devcenter admin network-connection delete

Elimine una conexión de red.

 Extensión GA
az devcenter admin network-connection list

Enumerar las conexiones de red.

 Extensión GA
az devcenter admin network-connection list-health-check

Enumera los detalles del estado de la comprobación de estado.

 Extensión GA
az devcenter admin network-connection list-outbound-network-dependencies-endpoint

Enumere los puntos de conexión a los que los agentes pueden llamar como parte de la administración del servicio Dev Box. Estos FQDN deben permitirse para el acceso saliente para que el servicio Dev Box funcione.

 Extensión GA
az devcenter admin network-connection run-health-check

Desencadena una nueva ejecución de comprobación de estado. El resultado de la comprobación de estado y la ejecución se puede realizar un seguimiento a través de los detalles de la comprobación de estado de la conexión de red.

 Extensión GA
az devcenter admin network-connection show

Obtenga una conexión de red.

 Extensión GA
az devcenter admin network-connection show-health-check

Obtenga los detalles del estado de la comprobación de estado.

 Extensión GA
az devcenter admin network-connection update

Actualice una conexión de red.

 Extensión GA
az devcenter admin network-connection wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA

az devcenter admin network-connection create

Cree una conexión de red.

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]

Ejemplos

Creación de una unión 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"

Creación de una unión a 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 requeridos

--domain-join-type

Tipo de combinación de AAD.

Valores aceptados: AzureADJoin, HybridAzureADJoin, None
--name --network-connection-name -n

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subnet-id

Subred a la que se van a adjuntar los cuadros de desarrollo.

Parámetros opcionales

--domain-name

Nombre de dominio de Active Directory.

--domain-password

Contraseña de la cuenta usada para unirse al dominio. Si el valor está en blanco, se le pregunta desde tty.

--domain-username

Nombre de usuario de una cuenta de Active Directory (cuenta de usuario o de servicio) que tiene permisos para crear objetos de equipo en Active Directory. Formato necesario: admin@contoso.com.

--location -l

Ubicación geográfica donde reside el recurso. Valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Cuando no se especifique, se usará la ubicación del grupo de recursos.

--networking-resource-group-name -r

Nombre del grupo de recursos donde se colocarán las NIC.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--organization-unit

Unidad de organización de dominio de Active Directory (UO).

--tags

Etiquetas de recursos. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection delete

Elimine una conexión de red.

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

Ejemplos

Borrar

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicite confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection list

Enumerar las conexiones de red.

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

Ejemplos

Enumeración por grupo de recursos

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

Enumeración por suscripción

az devcenter admin network-connection list

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection list-health-check

Enumera los detalles del estado de la comprobación de estado.

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

Ejemplos

Enumerar los detalles del estado de la comprobación de estado

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

Parámetros requeridos

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

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

Enumere los puntos de conexión a los que los agentes pueden llamar como parte de la administración del servicio Dev Box. Estos FQDN deben permitirse para el acceso saliente para que el servicio Dev Box funcione.

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

Ejemplos

Enumerar el punto de conexión de dependencias de red salientes

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

Parámetros requeridos

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection run-health-check

Desencadena una nueva ejecución de comprobación de estado. El resultado de la comprobación de estado y la ejecución se puede realizar un seguimiento a través de los detalles de la comprobación de estado de la conexión de red.

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]

Ejemplos

Ejecución de la comprobación de estado

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection show

Obtenga una conexión de red.

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

Ejemplos

Obtener

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection show-health-check

Obtenga los detalles del estado de la comprobación de estado.

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

Ejemplos

Obtención de la comprobación de estado

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection update

Actualice una conexión de red.

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]

Ejemplos

Actualizar

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

Parámetros opcionales

--domain-name

Nombre de dominio de Active Directory.

--domain-password

La contraseña de la cuenta usada para unir el dominio Si el valor está en blanco, se le pide desde tty.

--domain-username

Nombre de usuario de una cuenta de Active Directory (cuenta de usuario o de servicio) que tiene permisos para crear objetos de equipo en Active Directory. Formato necesario: admin@contoso.com.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la conexión de red que se puede aplicar a un grupo.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--organization-unit

Unidad de organización de dominio de Active Directory (UO).

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subnet-id

Subred a la que se van a asociar máquinas virtuales.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--tags

Etiquetas de recursos. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az devcenter admin network-connection wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

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

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name --network-connection-name -n

Nombre de la conexión de red que se puede aplicar a un grupo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.