Compartir a través de

az iot du account

Note

Esta referencia forma parte de la extensión azure-iot 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 iot du account. Obtenga más información sobre las extensiones.

Administración de cuentas de Device Update.

Comandos

Nombre Description Tipo Estado
az iot du account create

Cree una cuenta de Device Update.

 Extension GA
az iot du account delete

Elimina una cuenta de Device Update.

 Extension GA
az iot du account list

Enumere todas las cuentas de Device Update de una suscripción o grupo de recursos.

 Extension GA
az iot du account private-endpoint-connection

Administración de conexiones de punto de conexión privado de la cuenta de Device Update.

 Extension GA
az iot du account private-endpoint-connection delete

Elimine una conexión de punto de conexión privado asociada a una cuenta de Device Update.

 Extension GA
az iot du account private-endpoint-connection list

Enumera las conexiones de punto de conexión privado asociadas a una cuenta de Device Update.

 Extension GA
az iot du account private-endpoint-connection set

Establezca el estado de una conexión de punto de conexión privado asociada a una cuenta de Device Update.

 Extension GA
az iot du account private-endpoint-connection show

Mostrar una conexión de punto de conexión privado asociada a una cuenta de Device Update.

 Extension GA
az iot du account private-link-resource

Administración de recursos de vínculo privado de la cuenta de Device Update.

 Extension GA
az iot du account private-link-resource list

Enumera los recursos de private link admitidos por la cuenta.

 Extension GA
az iot du account show

Muestra los detalles de una cuenta de Device Update.

 Extension GA
az iot du account update

Actualizar una cuenta de Device Update.

 Extension GA
az iot du account wait

Bloquear hasta que se cumpla un estado de recurso de cuenta deseado.

 Extension GA

az iot du account create

Cree una cuenta de Device Update.

Este comando también se puede usar para actualizar el estado de una cuenta existente.

az iot du account create --account
                         --resource-group
                         [--assign-identity]
                         [--location]
                         [--no-wait]
                         [--pna --public-network-access {Disabled, Enabled}]
                         [--role]
                         [--scopes]
                         [--sku {Free, Standard}]
                         [--tags]

Ejemplos

Cree una cuenta de Device Update en el grupo de recursos de destino mediante la ubicación del grupo de recursos.

az iot du account create -n {account_name} -g {resouce_group}

Cree una cuenta gratuita de SKU Device Update en el grupo de recursos de destino con la ubicación y las etiquetas especificadas sin bloquear.

az iot du account create -n {account_name} -g {resouce_group} -l westus --tags a=b c=d --sku Free --no-wait

Cree una cuenta de Device Update en el grupo de recursos de destino con una identidad administrada por el sistema.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system]

Cree una cuenta de Device Update en el grupo de recursos de destino con una identidad administrada del sistema y, a continuación, asigne la identidad del sistema a un único ámbito con el rol Colaborador.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount

Cree una cuenta de Device Update en el grupo de recursos de destino con identidades administradas asignadas por el sistema y el usuario y, a continuación, asigne la identidad del sistema a uno o varios ámbitos (separados por espacios) con un rol especificado personalizado.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourcegroups/ProResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount1
  /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount2
--role "Storage Blob Data Contributor"

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--assign-identity

Acepta identidades asignadas por el sistema o por el usuario separadas por espacios. Use "[system]" para hacer referencia a la identidad asignada por el sistema o un identificador de recurso para hacer referencia a una identidad asignada por el usuario. Consulte la ayuda para obtener ejemplos.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
--location -l

Ubicación de la cuenta de Device Update. Si no se proporciona ninguna ubicación, se usa la ubicación del grupo de recursos. Puede configurar la ubicación predeterminada mediante az configure --defaults location={name}.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--pna --public-network-access

Indica si se puede acceder a la cuenta de Device Update desde una red pública.

Propiedad Valor
Grupo de parámetros: Network Arguments
Valor predeterminado: Enabled
Valores aceptados: Disabled, Enabled
--role

Nombre de rol o Identificador que tendrá la identidad asignada por el sistema.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
Valor predeterminado: Contributor
--scopes

Ámbitos separados por espacios a los que puede acceder la identidad asignada por el sistema. No se puede usar con --no-wait.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
--sku

SKU de la cuenta de Device Update.

Propiedad Valor
Valor predeterminado: Standard
Valores aceptados: Free, Standard
--tags

Etiquetas de recursos. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot du account delete

Elimina una cuenta de Device Update.

az iot du account delete --account
                         [--no-wait]
                         [--resource-group]
                         [--yes {false, true}]

Ejemplos

Elimine una cuenta de destino.

az iot du account delete -n {account_name}

Elimine una cuenta de destino sin confirmación ni bloqueo.

az iot du account delete -n {account_name} -y --no-wait

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Valor predeterminado: false.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot du account list

Enumere todas las cuentas de Device Update de una suscripción o grupo de recursos.

az iot du account list [--resource-group]

Ejemplos

Enumerar todas las cuentas de una suscripción.

az iot du account list

Enumera las cuentas de una suscripción que cumplen los criterios de filtro.

az iot du account list --query "[?tags.env == 'test']"

Enumerar todas las cuentas de un grupo de recursos.

az iot du account list -g {resource_group}

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot du account show

Muestra los detalles de una cuenta de Device Update.

az iot du account show --account
                       [--resource-group]

Ejemplos

Mostrar una cuenta de destino.

az iot du account show -n {account_name}

Mostrar un filtrado de cuentas de destino en una propiedad específica.

az iot du account show -n {account_name} --query identity

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot du account update

Actualizar una cuenta de Device Update.

Actualmente, se pueden actualizar las siguientes propiedades de cuenta: identidad, publicNetworkAccess y etiquetas.

az iot du account update --account
                         [--add]
                         [--force-string]
                         [--no-wait]
                         [--remove]
                         [--resource-group]
                         [--set]

Ejemplos

Establezca un atributo de etiqueta de cuenta específico.

az iot du account update -n {account_name} --set tags.env='test'

Deshabilita el acceso a una red pública.

az iot du account update -n {account_name} --set publicNetworkAccess='Disabled'

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: False
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot du account wait

Bloquear hasta que se cumpla un estado de recurso de cuenta deseado.

az iot du account wait --account
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--interval]
                       [--resource-group]
                       [--timeout]
                       [--updated]

Ejemplos

Bloquear hasta que un recurso de cuenta haya terminado de actualizarse.

az iot du account wait -n {account_name} -g {resource_group} --updated

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--created

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group={name}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False