az connectedmachine run-command
Nota:
Esta referencia forma parte de la extensión connectedmachine para la CLI de Azure (versión 2.49.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az connectedmachine run-command . Obtenga más información sobre las extensiones.
Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Administrar comandos de ejecución en un servidor habilitado para Azure Arc.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az connectedmachine run-command create |
Cree una operación para crear o actualizar un comando de ejecución. |
Extensión | Vista previa |
az connectedmachine run-command delete |
Operación de eliminación para eliminar un comando de ejecución. |
Extensión | Vista previa |
az connectedmachine run-command list |
Operación de lista para obtener todos los comandos de ejecución de una máquina que no es de Azure. |
Extensión | Vista previa |
az connectedmachine run-command show |
Obtenga la operación para obtener un comando de ejecución. |
Extensión | Vista previa |
az connectedmachine run-command update |
Operación de actualización para crear o actualizar un comando de ejecución. |
Extensión | Vista previa |
az connectedmachine run-command wait |
Coloque la CLI en un estado de espera hasta que se cumpla una condición. |
Extensión | Vista previa |
az connectedmachine run-command create
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Cree una operación para crear o actualizar un comando de ejecución.
az connectedmachine run-command create --machine-name
--name
--resource-group
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--command-id]
[--error-blob-managed-identity]
[--error-blob-uri]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--run-as-user]
[--script]
[--script-uri]
[--script-uri-managed-id]
[--tags]
[--timeout]
Ejemplos
Comando de ejemplo para run-command create
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription"
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --name "myRunCommand" --machine-name "myMachine" --output-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D" --subscription "mySubscription"
Parámetros requeridos
Nombre de la máquina híbrida.
Nombre del comando run.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.
Especifica el commandId del script integrado predefinido.
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento errorBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y Ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica el blob de Azure Storage donde se cargará el flujo de error del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro errorBlobManagedIdentity.
Ubicación geográfica donde reside el recurso Cuando no se especifica, se usará la ubicación del grupo de recursos.
No espere hasta que finalice la operación de ejecución prolongada.
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento outputBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y Ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro outputBlobManagedIdentity.
Parámetros usados por el script. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica la contraseña de la cuenta de usuario en el equipo al ejecutar el comando run.
Parámetros usados por el script. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica la cuenta de usuario en el equipo al ejecutar el comando run.
Especifica el contenido del script que se va a ejecutar en la máquina.
Especifica la ubicación de descarga del script. Puede ser un URI de SAS de un blob de Azure Storage con acceso de lectura o URI público.
Identidad administrada asignada por el usuario que tiene acceso a scriptUri en caso de blob de Azure Storage. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que existe el blob de Azure Storage y de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Lector de datos de blobs de almacenamiento". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y Ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Tiempo de espera en segundos para ejecutar el comando run.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az connectedmachine run-command delete
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Operación de eliminación para eliminar un comando de ejecución.
az connectedmachine run-command delete [--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Ejemplos
Comando de ejemplo para run-command delete
az connectedmachine run-command delete --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
Parámetros opcionales
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Nombre de la máquina híbrida.
Nombre del comando run.
No espere hasta que finalice la operación de ejecución prolongada.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az connectedmachine run-command list
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Operación de lista para obtener todos los comandos de ejecución de una máquina que no es de Azure.
az connectedmachine run-command list --machine-name
--resource-group
[--expand]
Ejemplos
Comando de ejemplo para run-command list
az connectedmachine run-command list --resource-group "myResourceGroup" --machine-name "myMachine"
Parámetros requeridos
Nombre de la máquina híbrida.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Expresión expand que se va a aplicar en la operación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az connectedmachine run-command show
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Obtenga la operación para obtener un comando de ejecución.
az connectedmachine run-command show [--ids]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Comando de ejemplo para run-command show
az connectedmahine run-command show --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
Parámetros opcionales
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Nombre de la máquina híbrida.
Nombre del comando run.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az connectedmachine run-command update
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Operación de actualización para crear o actualizar un comando de ejecución.
az connectedmachine run-command update [--add]
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--error-blob-managed-identity]
[--error-blob-uri]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--remove]
[--resource-group]
[--run-as-user]
[--set]
[--source]
[--subscription]
[--tags]
[--timeout]
Ejemplos
Comando de ejemplo para la actualización de run-command
az connetcedmachine run-command update --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription" --tags Tag1=Value1
Parámetros opcionales
Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.
Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento errorBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y Ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica el blob de Azure Storage donde se cargará el flujo de error del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro errorBlobManagedIdentity.
Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Nombre de la máquina híbrida.
Nombre del comando run.
No espere hasta que finalice la operación de ejecución prolongada.
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento outputBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y Ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro outputBlobManagedIdentity.
Parámetros usados por el script. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Especifica la contraseña de la cuenta de usuario en el equipo al ejecutar el comando run.
Parámetros usados por el script. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Especifica la cuenta de usuario en el equipo al ejecutar el comando run.
Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.
Origen del script de comando de ejecución. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Tiempo de espera en segundos para ejecutar el comando run.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az connectedmachine run-command wait
El grupo de comandos "az connectedmachine run-command" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Coloque la CLI en un estado de espera hasta que se cumpla una condición.
az connectedmachine run-command wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parámetros opcionales
Espere hasta que se cree con "provisioningState" en "Succeeded".
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Espere hasta que se elimine.
Espere hasta que exista el recurso.
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Intervalo de sondeo en segundos.
Nombre de la máquina híbrida.
Nombre del comando run.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Espera máxima en segundos.
Espere hasta que se actualice con provisioningState en "Succeeded".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de