Referência da CLI azcmagent

A ferramenta azcmagentde linha de comando do agente do Azure Connected Machine ajuda você a configurar, gerenciar e solucionar problemas de conexão de um servidor com o Azure Arc. A azcmagent CLI é instalada com o agente do Azure Connected Machine e controla ações específicas para o servidor em que está em execução. Depois que o servidor estiver conectado ao Azure Arc, você poderá usar a CLI do Azure ou o módulo do Azure PowerShell para habilitar extensões, gerenciar marcas e executar outras operações no recurso do servidor.

A menos que especificado de outra forma, a sintaxe de comando e os sinalizadores representam as opções disponíveis na versão mais recente do agente do Azure Connected Machine. Para obter mais informações, consulte Novidades do agente do Azure Connected Machine.

Para obter detalhes sobre os comandos individuais disponíveis na azcmagent CLI, execute azcmagent COMMANDNAME --help ou veja as seguintes páginas de referência:

Comandos

Sinalizadores comuns

Todos os azcmagent comandos dão suporte aos sinalizadores a seguir. Para ver se um comando dá suporte a outros sinalizadores, verifique sua página de referência.

--config

Usa um caminho para um arquivo JSON ou YAML que contém entradas para o comando. O arquivo de configuração deve conter uma série de pares de chave-valor em que a chave corresponde a uma opção de linha de comando disponível. Por exemplo, para passar o --verbose sinalizador, o arquivo de configuração ficaria assim:

{
    "verbose": true
}

Se uma opção de linha de comando for encontrada na chamada de comando e em um arquivo de configuração, o valor especificado na linha de comando terá precedência.

-h, --help

Obtenha ajuda para o comando atual, incluindo sua sintaxe e opções de linha de comando.

-j, --json

Imprima o resultado do comando no formato JSON.

--log-stderr

Redirecione mensagens de erro e detalhadas para o fluxo de erro padrão (stderr). Por padrão, toda a saída é enviada para o fluxo de saída padrão (stdout).

--no-color

Desative a saída de cores para terminais que não suportam cores ANSI.

-v, --verbose

Mostre informações de log mais detalhadas enquanto o comando é executado. Útil para solucionar problemas ao executar um comando.

Perguntas frequentes

Como posso instalar a CLI azcmagent?

A azcmagent CLI é agrupada com o agente do Azure Connected Machine. Para saber mais sobre os métodos para instalar e configurar o agente, consulte as opções de implantação do agente do Azure Connected Machine.

Onde a CLI está instalada?

Nos sistemas operacionais Windows, a CLI é instalada no %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe. Esse caminho é adicionado automaticamente à variável PATH do sistema durante o processo de instalação. Talvez seja necessário fechar e reabrir o console para atualizar a variável PATH e poder executá-la azcmagent sem especificar o caminho completo.

Nos sistemas operacionais Linux, a CLI é instalada em /opt/azcmagent/bin/azcmagent.

Qual é a diferença entre a azcmagent CLI e a CLI do Azure para servidores habilitados para Azure Arc?

A azcmagent CLI é usada para configurar o agente local. Ele é responsável por conectar o agente ao Azure, desconectá-lo e definir configurações locais, como URLs de proxy e recursos de segurança.

A CLI do Azure e outras experiências de gerenciamento são usadas para interagir com o recurso do Azure Arc no Azure depois que o agente é conectado. Essas ferramentas ajudam você a gerenciar extensões, mover o recurso para outra assinatura ou grupo de recursos e alterar determinadas configurações do servidor Arc remotamente.