referência da CLI azcmagent

A ferramenta de linha de comandos do agente Azure Connected Machine, azcmagent, ajuda-o a configurar, gerir e resolver problemas na ligação de um servidor com o Azure Arc. A azcmagent CLI está instalada com o agente Azure Connected Machine e controla ações específicas do servidor onde está a correr. 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 tags e executar outras operações no recurso do servidor.

A menos que especificado de outra forma, a sintaxe de comando e os sinalizadores representam opções disponíveis na versão mais recente do agente de Máquina Conectada do Azure. 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 consulte as seguintes páginas de referência:

Comandos

Bandeiras comuns

Todos azcmagent os comandos suportam as seguintes bandeiras. Para ver se um comando suporta outras bandeiras, consulte a página de referências.

--config

Leva um caminho para um arquivo JSON ou YAML contendo entradas para o comando. O arquivo de configuração deve conter uma série de pares 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 teria a seguinte aparência:

{
    "verbose": true
}

Se uma opção de linha de comando for encontrada na invocação 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 suas opções de sintaxe e linha de comando.

-j, --json

Saída do resultado do comando no formato JSON.

--log-stderr

Redirecionar 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

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

Perguntas mais frequentes

Como posso instalar a CLI azcmagent?

A azcmagent CLI está incluída com o agente Azure Connected Machine. Para aprender métodos para instalar e configurar o agente, consulte as opções de implementação do agente Azure Connected Machine.

Onde a CLI está instalada?

Em sistemas operacionais Windows, a CLI é instalada em %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe. Este 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 executar azcmagent sem especificar o caminho completo.

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

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

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 Azure Arc no Azure assim que o agente estiver 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.