az connectedmachine

Remarque

Cette référence fait partie de l’extension connectedmachine pour Azure CLI (version 2.49.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az connectedmachine . En savoir plus sur les extensions.

Gérer un serveur avec Azure Arc.

Commandes

Nom	Description	Type	Statut
az connectedmachine assess-patches	Évaluez les correctifs sur un serveur avec Azure Arc.	Extension	GA
az connectedmachine delete	Opération de suppression pour supprimer un serveur avec Azure Arc.	Extension	GA
az connectedmachine extension	Gérer une extension de machine virtuelle sur un serveur avec Azure Arc.	Extension	GA
az connectedmachine extension create	Opération de création de l’extension.	Extension	GA
az connectedmachine extension delete	Opération de suppression de l’extension.	Extension	GA
az connectedmachine extension image	Gérer les métadonnées d’extension de machine virtuelle disponibles pour les serveurs avec Azure Arc.	Extension	GA
az connectedmachine extension image list	Répertorie toutes les versions d’extension basées sur l’emplacement, l’éditeur, l’extensionType.	Extension	GA
az connectedmachine extension image show	Obtenez des métadonnées d’extension en fonction de l’emplacement, de l’éditeur, de l’extensionType et de la version.	Extension	GA
az connectedmachine extension list	Opération permettant d’obtenir toutes les extensions d’une machine non-Azure.	Extension	GA
az connectedmachine extension show	Opération de création ou de mise à jour de l’extension.	Extension	GA
az connectedmachine extension update	Opération de mise à jour pour mettre à jour l’extension.	Extension	GA
az connectedmachine extension wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Extension	GA
az connectedmachine install-patches	Installez les correctifs sur un serveur avec Azure Arc.	Extension	GA
az connectedmachine list	Répertoriez tous les serveurs avec Azure Arc dans le groupe de ressources spécifié.	Extension	GA
az connectedmachine private-endpoint-connection	Gérer la connexion de point de terminaison privé avec un serveur avec Azure Arc.	Extension	GA
az connectedmachine private-endpoint-connection delete	Supprimez une connexion de point de terminaison privé avec un nom donné.	Extension	GA
az connectedmachine private-endpoint-connection list	Répertorier toutes les connexions de point de terminaison privé sur une étendue de liaison privée.	Extension	GA
az connectedmachine private-endpoint-connection show	Obtenir une connexion de point de terminaison privé.	Extension	GA
az connectedmachine private-endpoint-connection update	Mettez à jour une connexion de point de terminaison privé avec un nom donné.	Extension	GA
az connectedmachine private-endpoint-connection wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Extension	GA
az connectedmachine private-link-resource	Gérer la ressource de liaison privée d’un serveur avec Azure Arc.	Extension	GA
az connectedmachine private-link-resource list	Répertoriez les ressources de liaison privée qui doivent être créées pour un PrivateLinkScope Azure Monitor.	Extension	GA
az connectedmachine private-link-resource show	Obtenez les ressources de liaison privée qui doivent être créées pour un PrivateLinkScope Azure Monitor.	Extension	GA
az connectedmachine private-link-scope	Gérer l’étendue de liaison privée d’un serveur avec Azure Arc.	Extension	GA
az connectedmachine private-link-scope create	Créez (ou met à jour) un Azure Arc PrivateLinkScope. Remarque : Vous ne pouvez pas spécifier une valeur différente pour InstrumentationKey ni AppId dans l’opération Put.	Extension	GA
az connectedmachine private-link-scope delete	Supprimez un PrivateLinkScope Azure Arc.	Extension	GA
az connectedmachine private-link-scope list	Obtenez une liste d’Azure Arc PrivateLinkScopes au sein d’un groupe de ressources. Obtient une liste de tous les Azure Arc PrivateLinkScopes au sein d’un abonnement.	Extension	GA
az connectedmachine private-link-scope show	Retournez un PrivateLinkScope Azure Arc.	Extension	GA
az connectedmachine private-link-scope update	Mettez à jour un PrivateLinkScope Azure Arc. Remarque : Vous ne pouvez pas spécifier une valeur différente pour InstrumentationKey ni AppId dans l’opération Put.	Extension	GA
az connectedmachine private-link-scope update-tag	Mettez à jour les balises d’un PrivateLinkScope existant. Pour mettre à jour d’autres champs, utilisez la méthode CreateOrUpdate.	Extension	GA
az connectedmachine private-link-scope wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Extension	GA
az connectedmachine run-command	Gérer les commandes d’exécution sur un serveur avec Azure Arc.	Extension	Aperçu
az connectedmachine run-command create	Créez une opération pour créer ou mettre à jour une commande d’exécution.	Extension	Aperçu
az connectedmachine run-command delete	Opération de suppression pour supprimer une commande d’exécution.	Extension	Aperçu
az connectedmachine run-command list	Répertorier l’opération pour obtenir toutes les commandes d’exécution d’une machine non-Azure.	Extension	Aperçu
az connectedmachine run-command show	Obtenir l’opération pour obtenir une commande d’exécution.	Extension	Aperçu
az connectedmachine run-command update	Opération de mise à jour pour créer ou mettre à jour une commande d’exécution.	Extension	Aperçu
az connectedmachine run-command wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Extension	Aperçu
az connectedmachine show	Obtenez des informations sur la vue de modèle ou l’affichage d’instance d’un serveur avec Azure Arc.	Extension	GA
az connectedmachine update	Mettez à jour un serveur avec Azure Arc. Notez que certaines propriétés peuvent être définies uniquement lors de la création de la machine.	Extension	GA
az connectedmachine upgrade-extension	Opération de mise à niveau des extensions de machine.	Extension	GA

az connectedmachine assess-patches

Évaluez les correctifs sur un serveur avec Azure Arc.

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

Exemples

Exemple de commande pour les correctifs d’évaluation

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la machine hybride.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine delete

Opération de suppression pour supprimer un serveur avec Azure Arc.

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

Exemples

Exemple de commande pour la suppression

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--machine-name --name -n

Nom de la machine hybride.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine install-patches

Installez les correctifs sur un serveur avec 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]

Exemples

Exemple de commande pour les correctifs d’installation

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

Paramètres obligatoires

--maximum-duration

Spécifie la durée maximale pendant laquelle l’opération s’exécutera. Il doit s’agir d’une chaîne de durée conforme ISO 8601 telle que PT4H (4 heures).

--reboot-setting

Définit quand il est acceptable de redémarrer une machine virtuelle pendant une opération de mise à jour logicielle.

valeurs acceptées: Always, IfRequired, Never

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--linux-parameters

Entrée pour InstallPatches sur une machine virtuelle Linux, telle que reçue directement par la prise en charge de la syntaxe abrégée, json-file et yaml-file de l’API. Essayez « ?? » pour en montrer plus.

--name -n

Nom de la machine hybride.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--windows-parameters

Entrée pour InstallPatches sur une machine virtuelle Windows, telle que reçue directement par la prise en charge de la syntaxe abrégée, json-file et yaml-file de l’API. Essayez « ?? » pour en montrer plus.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine list

Répertoriez tous les serveurs avec Azure Arc dans le groupe de ressources spécifié.

az connectedmachine list --resource-group
                         [--expand]

Exemples

Exemple de commande pour la liste

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

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--expand

Développe les ressources référencées.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine show

Obtenez des informations sur la vue de modèle ou l’affichage d’instance d’un serveur avec Azure Arc.

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

Exemples

Exemple de commande pour show

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

Paramètres facultatifs

--expand

Expression de développement à appliquer à l’opération.

valeurs acceptées: instanceView

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--machine-name --name -n

Nom de la machine hybride.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine update

Mettez à jour un serveur avec Azure Arc. Notez que certaines propriétés peuvent être définies uniquement lors de la création de la machine.

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-resource-id]
                           [--remove]
                           [--resource-group]
                           [--service-statuses]
                           [--set]
                           [--subscription]
                           [--tags]

Exemples

Exemple de commande pour la mise à jour

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

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string ou JSON string>.

--agent-upgrade

Informations de la machine w.r.t Agent Upgrade Support shorthand-syntax, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--client-public-key

Clé publique que le client fournit pour être utilisé lors de l’intégration initiale des ressources.

--expand

Expression de développement à appliquer à l’opération.

valeurs acceptées: instanceView

--extensions

Les informations sur les extensions de machine (champ déconseillé) prennent en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

--identity

Identité de la ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--kind

Indique le type de placement de machine Arc local, tel que HCI, SCVMM ou VMware, etc.

valeurs acceptées: AVS, AWS, EPS, GCP, HCI, SCVMM, VMware

--license-profile

Spécifie les propriétés associées à la licence d’un ordinateur. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--location-data

Métadonnées relatives à l’emplacement géographique de la ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--machine-name --name -n

Nom de la machine hybride.

--mssql-discovered

Spécifie si une instance MS SQL est découverte sur l’ordinateur.

--os-profile

Spécifie les paramètres du système d’exploitation pour la machine hybride. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--os-type

Type de système d’exploitation (windows/linux).

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

L’ID de ressource du cluster parent (Azure HCI) auquel cette machine est affectée, le cas échéant.

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

L’ID de ressource de l’étendue de liaison privée à laquelle cette machine est affectée, le cas échéant.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--service-statuses

État des services dépendants qui sont renvoyés à ARM. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--tags

Balises de ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az connectedmachine upgrade-extension

Opération de mise à niveau des extensions de machine.

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

Exemples

Exemple de commande pour la mise à niveau d’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"}"}"

Paramètres facultatifs

--extension-targets

Décrit les propriétés de la cible d’extension. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--machine-name

Nom de la machine hybride.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.