Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La herramienta de línea de comandos del agente de Azure Connected Machine, azcmagent, le ayuda a configurar, administrar y solucionar problemas de conexión de un servidor con Azure Arc. La azcmagent CLI se instala con el agente de Azure Connected Machine y controla las acciones específicas del servidor donde se ejecuta. Una vez que el servidor está conectado a Azure Arc, puede usar la CLI de Azure o el módulo de Azure PowerShell para habilitar extensiones, administrar etiquetas y realizar otras operaciones en el recurso de servidor.
A menos que se especifique lo contrario, la sintaxis de comandos y las marcas representan las opciones disponibles en la versión más reciente del agente de Azure Connected Machine. Para más información, consulte Novedades del agente de Azure Connected Machine.
Para obtener detalles sobre los comandos individuales disponibles en la azcmagent CLI, ejecute azcmagent COMMANDNAME --help o vea las páginas de referencia siguientes:
Comandos
| Get-Help | Propósito |
|---|---|
azcmagent check |
Ejecución de comprobaciones de conectividad de red para puntos de conexión de Azure Arc |
azcmagent config |
Administrar la configuración del agente. |
azcmagent connect |
Conecte el servidor a Azure Arc. |
azcmagent disconnect |
Desconecte el servidor de Azure Arc. |
azcmagent genkey |
Genere un par de claves pública-privada para la incorporación asincrónica. |
azcmagent help |
Obtenga ayuda para los comandos. |
azcmagent license |
Muestra el contrato de licencia de usuario final. |
azcmagent logs |
Recopile registros para solucionar problemas del agente. |
azcmagent show |
Muestra el estado del agente. |
azcmagent version |
Muestra la versión del agente. |
azcmagent partnerconfig |
Reservado para uso interno. |
Marcas comunes
Todos los azcmagent comandos admiten las marcas siguientes. Para ver si un comando admite otras marcas, compruebe su página de referencia.
--config
Toma una ruta de acceso a un archivo JSON o YAML que contiene entradas al comando. El archivo de configuración debe contener una serie de pares clave-valor donde la clave coincide con una opción de línea de comandos disponible. Por ejemplo, para pasar la --verbose marca, el archivo de configuración tendría el siguiente aspecto:
{
"verbose": true
}
Si se encuentra una opción de línea de comandos en la invocación de comandos y en un archivo de configuración, el valor especificado en la línea de comandos tendrá prioridad.
-h, --help
Obtenga ayuda para el comando actual, incluida su sintaxis y opciones de línea de comandos.
-j, --json
Genera el resultado del comando en formato JSON.
--log-stderr
Redirigir mensajes de error y detallados al flujo de error estándar (stderr). De forma predeterminada, toda la salida se envía al flujo de salida estándar (stdout).
--no-color
Deshabilite la salida de color para los terminales que no admiten colores ANSI.
-v, --verbose
Mostrar información de registro más detallada mientras se ejecuta el comando. Resulta útil para solucionar problemas al ejecutar un comando.
Preguntas más frecuentes
¿Cómo puedo instalar la CLI de azcmagent?
La azcmagent CLI se incluye con el agente de Azure Connected Machine. Para más información sobre los métodos para instalar y configurar el agente, consulte Opciones de implementación del agente de Azure Connected Machine.
¿Dónde está instalada la CLI?
En los sistemas operativos Windows, la CLI se instala en %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe. Esta ruta de acceso se agrega automáticamente a la variable PATH del sistema durante el proceso de instalación. Es posible que tenga que cerrar y volver a abrir la consola para actualizar la variable PATH y poder ejecutarse azcmagent sin especificar la ruta de acceso completa.
En sistemas operativos Linux, la CLI se instala en /opt/azcmagent/bin/azcmagent.
¿Cuál es la diferencia entre la azcmagent CLI y la CLI de Azure para servidores habilitados para Azure Arc?
La azcmagent CLI se usa para configurar el agente local. Es responsable de conectar el agente a Azure, desconectarlo y configurar opciones locales, como direcciones URL de proxy y características de seguridad.
La CLI de Azure y otras experiencias de administración se usan para interactuar con el recurso de Azure Arc en Azure una vez conectado el agente. Estas herramientas le ayudan a administrar extensiones, mover el recurso a otra suscripción o grupo de recursos y cambiar determinadas configuraciones del servidor de Arc de forma remota.