az connectedmachine

Observação

Essa referência faz parte da extensão connectedmachine para a CLI do Azure (versão 2.57.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az connectedmachine . Saiba mais sobre extensões.

Gerenciar servidor habilitado para Azure Arc.

Comandos

Nome	Description	Tipo	Status
az connectedmachine assess-patches	Avalie patches em um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine delete	Exclua um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine extension	Gerencie uma extensão de VM em um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine extension create	Criar uma extensão.	Extensão	GA
az connectedmachine extension delete	Exclua uma extensão.	Extensão	GA
az connectedmachine extension image	Gerencie metadados de extensão de VM disponíveis para servidores habilitados para Azure Arc.	Extensão	GA
az connectedmachine extension image list	Liste todas as versões de extensão com base no local, editor, extensionType.	Extensão	GA
az connectedmachine extension image show	Obtenha metadados de extensão com base no local, editor, extensionType e versão.	Extensão	GA
az connectedmachine extension list	Obtenha todas as extensões de um computador que não seja do Azure.	Extensão	GA
az connectedmachine extension show	Mostrar uma extensão de um computador que não é do Azure.	Extensão	GA
az connectedmachine extension update	Atualize uma extensão.	Extensão	GA
az connectedmachine extension wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Extensão	GA
az connectedmachine install-patches	Instale patches em um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine license	Gerencie a licença ESU em um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine license create	Crie uma licença.	Extensão	GA
az connectedmachine license delete	Exclua uma licença.	Extensão	GA
az connectedmachine license list	Obtenha todas as licenças de um computador que não seja do Azure.	Extensão	GA
az connectedmachine license show	Obtenha informações sobre a exibição de uma licença.	Extensão	GA
az connectedmachine license update	Operação de atualização para atualizar uma licença.	Extensão	GA
az connectedmachine license wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Extensão	GA
az connectedmachine list	Liste todos os servidores habilitados para Azure Arc no grupo de recursos especificado.	Extensão	GA
az connectedmachine private-endpoint-connection	Gerencie a conexão de ponto de extremidade privado com um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine private-endpoint-connection delete	Exclua uma conexão de ponto de extremidade privado com um determinado nome.	Extensão	GA
az connectedmachine private-endpoint-connection list	Liste todas as conexões de ponto de extremidade privado em um escopo de link privado.	Extensão	GA
az connectedmachine private-endpoint-connection show	Obtenha uma conexão de ponto de extremidade privado.	Extensão	GA
az connectedmachine private-endpoint-connection update	Atualize uma conexão de ponto de extremidade privado com um determinado nome.	Extensão	GA
az connectedmachine private-endpoint-connection wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Extensão	GA
az connectedmachine private-link-resource	Gerenciar o recurso de link privado de um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine private-link-resource list	Liste os recursos de link privado que precisam ser criados para um PrivateLinkScope do Azure Monitor.	Extensão	GA
az connectedmachine private-link-resource show	Obtenha os recursos de link privado que precisam ser criados para um PrivateLinkScope do Azure Monitor.	Extensão	GA
az connectedmachine private-link-scope	Gerencie o escopo do link privado de um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine private-link-scope create	Crie um Azure Arc PrivateLinkScope. Observação: não é possível especificar um valor diferente para InstrumentationKey nem AppId na operação Put.	Extensão	GA
az connectedmachine private-link-scope delete	Exclua um PrivateLinkScope do Azure Arc.	Extensão	GA
az connectedmachine private-link-scope list	Obtenha uma lista de PrivateLinkScopes do Azure Arc para um grupo de recursos ou uma assinatura.	Extensão	GA
az connectedmachine private-link-scope network-security-perimeter-configuration	Gerencie a configuração do perímetro de segurança de rede em um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine private-link-scope network-security-perimeter-configuration list	Liste as configurações de perímetro de segurança de rede para um escopo de link privado.	Extensão	GA
az connectedmachine private-link-scope network-security-perimeter-configuration show	Obtenha a configuração do perímetro de segurança de rede para um escopo de link privado.	Extensão	GA
az connectedmachine private-link-scope show	Obtenha um Azure Arc PrivateLinkScope.	Extensão	GA
az connectedmachine private-link-scope update	Atualize um PrivateLinkScope do Azure Arc. Observação: não é possível especificar um valor diferente para InstrumentationKey nem AppId na operação Put.	Extensão	GA
az connectedmachine private-link-scope update-tag	Atualize as marcas de um PrivateLinkScope existente. Para atualizar outros campos, use o método CreateOrUpdate.	Extensão	GA
az connectedmachine private-link-scope wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Extensão	GA
az connectedmachine run-command	Gerencie comandos de execução em um servidor habilitado para Azure Arc.	Extensão	Visualizar
az connectedmachine run-command create	Crie um comando de execução.	Extensão	Visualizar
az connectedmachine run-command delete	Exclua um comando de execução.	Extensão	Visualizar
az connectedmachine run-command list	Obtenha todos os comandos de execução de um computador que não seja do Azure.	Extensão	Visualizar
az connectedmachine run-command show	Obtenha um comando de execução.	Extensão	Visualizar
az connectedmachine run-command update	Atualize um comando de execução.	Extensão	Visualizar
az connectedmachine run-command wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Extensão	Visualizar
az connectedmachine show	Obtenha informações sobre a exibição do modelo ou a exibição de instância de um servidor habilitado para Azure Arc.	Extensão	GA
az connectedmachine update	Atualize um servidor habilitado para Azure Arc. Observe que algumas propriedades podem ser definidas apenas durante a criação da máquina.	Extensão	GA
az connectedmachine upgrade-extension	Atualizar extensões de máquina.	Extensão	GA

az connectedmachine assess-patches

Avalie patches em um servidor habilitado para Azure Arc.

az connectedmachine assess-patches [--ids]
                                   [--name]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--resource-group]
                                   [--subscription]

Exemplos

Comando de exemplo para assess-patches

az connectedmachine assess-patches --resource-group MyResourceGroup --name MyMachine

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome da máquina híbrida.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine delete

Exclua um servidor habilitado para Azure Arc.

az connectedmachine delete [--ids]
                           [--machine-name]
                           [--resource-group]
                           [--subscription]
                           [--yes]

Exemplos

Exemplo de comando para exclusão

az connectedmachine delete --name myMachine --resource-group myResourceGroup

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--machine-name --name -n

O nome da máquina híbrida.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine install-patches

Instale patches em um servidor habilitado para Azure Arc.

az connectedmachine install-patches --maximum-duration
                                    --reboot-setting {Always, IfRequired, Never}
                                    [--ids]
                                    [--linux-parameters]
                                    [--name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--resource-group]
                                    [--subscription]
                                    [--windows-parameters]

Exemplos

Exemplo de comando para install-patches

az connectedmachine install-patches --resource-group MyResourceGroup --name MyMachine --maximum-duration PT4H --reboot-setting IfRequired --windows-parameters "{"classificationsToInclude": ["Critical", "Security"]}"

Parâmetros Exigidos

--maximum-duration

Especifica a quantidade máxima de tempo que a operação será executada. Deve ser uma cadeia de caracteres de duração compatível com ISO 8601, como PT4H (4 horas).

--reboot-setting

Define quando é aceitável reinicializar uma VM durante uma operação de atualização de software.

Valores aceitos: Always, IfRequired, Never

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--linux-parameters

Entrada para InstallPatches em uma VM do Linux, conforme recebido diretamente pela sintaxe abreviada de suporte à API, json-file e yaml-file. Tente "??" para mostrar mais.

--name -n

O nome da máquina híbrida.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--windows-parameters

Entrada para InstallPatches em uma VM do Windows, conforme recebido diretamente pela sintaxe abreviada de suporte à API, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine list

Liste todos os servidores habilitados para Azure Arc no grupo de recursos especificado.

az connectedmachine list --resource-group
                         [--expand]
                         [--max-items]
                         [--next-token]

Exemplos

Exemplo de comando para lista

az connectedmachine list --resource-group myResourceGroup
az connectedmachine list

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--expand

Expande os recursos referenciados.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Esse é o valor do token de uma resposta truncada anteriormente.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine show

Obtenha informações sobre a exibição do modelo ou a exibição de instância de um servidor habilitado para Azure Arc.

az connectedmachine show [--expand {instanceView}]
                         [--ids]
                         [--machine-name]
                         [--resource-group]
                         [--subscription]

Exemplos

Comando de exemplo para show

az connectedmachine show --name myMachine --resource-group myResourceGroup

Parâmetros Opcionais

--expand

A expressão de expansão a ser aplicada na operação.

Valores aceitos: instanceView

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--machine-name --name -n

O nome da máquina híbrida.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine update

Atualize um servidor habilitado para Azure Arc. Observe que algumas propriedades podem ser definidas apenas durante a criação da máquina.

az connectedmachine update [--add]
                           [--agent-upgrade]
                           [--client-public-key]
                           [--expand {instanceView}]
                           [--extensions]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--identity]
                           [--ids]
                           [--kind {AVS, AWS, EPS, GCP, HCI, SCVMM, VMware}]
                           [--license-profile]
                           [--location-data]
                           [--machine-name]
                           [--mssql-discovered]
                           [--os-profile]
                           [--os-type]
                           [--parent-cluster-id]
                           [--private-link-scope-id]
                           [--remove]
                           [--resource-group]
                           [--service-statuses]
                           [--set]
                           [--subscription]
                           [--tags]

Exemplos

Exemplo de comando para atualização

az connectedmachine update --name myMachine --resource-group myResourceGroup --location eastus2euap

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um par de caminho e um valor-chave. Exemplo: --add property.listProperty <key=value, string ou string> JSON.

--agent-upgrade

As informações da máquina w.r.t Agent Upgrade Suporta sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--client-public-key

Chave pública que o cliente fornece para ser usada durante a integração inicial de recursos.

--expand

A expressão de expansão a ser aplicada na operação.

Valores aceitos: instanceView

--extensions

Informações de extensões de máquina (campo obsoleto) Suporta sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

Ao usar 'set' ou 'add', preserve os literais de string em vez de tentar converter em JSON.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--identity

Identidade do recurso. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--kind

Indica que tipo de posicionamento de máquina Arc no local, como HCI, SCVMM ou VMware etc.

Valores aceitos: AVS, AWS, EPS, GCP, HCI, SCVMM, VMware

--license-profile

Especifica as propriedades relacionadas à licença para uma máquina. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--location-data

Metadados relativos à localização geográfica do recurso. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--machine-name --name -n

O nome da máquina híbrida.

--mssql-discovered

Especifica se alguma instância do MS SQL é descoberta na máquina.

--os-profile

Especifica as configurações do sistema operacional para o computador híbrido. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--os-type

O tipo de sistema operacional (windows/linux).

--parent-cluster-id --parent-cluster-resource-id

A ID do recurso do cluster pai (Azure HCI) ao qual esse computador está atribuído, se houver.

--private-link-scope-id --private-link-scope-resource-id

A ID do recurso do escopo de link privado ao qual esta máquina está atribuída, se houver.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service-statuses

Status de serviços dependentes que são relatados de volta ao ARM. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--tags

Tags de recursos. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine upgrade-extension

Atualizar extensões de máquina.

az connectedmachine upgrade-extension [--extension-targets]
                                      [--ids]
                                      [--machine-name]
                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--resource-group]
                                      [--subscription]

Exemplos

Exemplo de comando para upgrade-extension

az connectedmachine extension upgrade --machine-name "myMachineName" --resource-group "myResourceGroup" --subscription "mySubscription" --targets "{"Microsoft.Compute.CustomScriptExtension": "{"targetVersion": "1.10"}", "Microsoft.Azure.Monitoring": "{"targetVersion": "2.0"}"}"

Parâmetros Opcionais

--extension-targets

Descreve as propriedades de destino da extensão. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--machine-name

O nome da máquina híbrida.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.