az guestconfig guest-configuration-assignment

Expérimental

Note

Cette référence fait partie de l’extension guestconfig pour Azure CLI (version 2.3.1 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az guestconfig guest-configuration-assignment commande. Apprenez-en davantage sur les extensions.

Ce groupe de commandes est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Guestconfig guest-configuration-assignment.

Commandes

Nom	Description	Type	État
az guestconfig guest-configuration-assignment create	Crée une association entre une machine virtuelle et une configuration invité.	Extension	Experimental
az guestconfig guest-configuration-assignment delete	Supprimez une attribution de configuration d’invité.	Extension	Experimental
az guestconfig guest-configuration-assignment list	Répertorier toutes les attributions de configuration d’invité pour une machine virtuelle.	Extension	Experimental
az guestconfig guest-configuration-assignment show	Obtenez des informations sur une attribution de configuration d’invité.	Extension	Experimental
az guestconfig guest-configuration-assignment update	Crée une association entre une machine virtuelle et une configuration invité.	Extension	Experimental
az guestconfig guest-configuration-assignment wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’attribution guest-configuration guestconfig soit remplie.	Extension	Experimental

az guestconfig guest-configuration-assignment create

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Crée une association entre une machine virtuelle et une configuration invité.

az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name
                                                     --resource-group
                                                     --vm-name
                                                     [--context]
                                                     [--guest-configuration-configuration-parameter]
                                                     [--guest-configuration-configuration-setting]
                                                     [--guest-configuration-name]
                                                     [--guest-configuration-version]
                                                     [--latest-assignment-report-assignment]
                                                     [--location]
                                                     [--name]
                                                     [--no-wait]

Exemples

Créer ou mettre à jour l’attribution de configuration d’invité

az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"

Paramètres obligatoires

--guest-configuration-assignment-name

Nom de l’attribution de configuration d’invité.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--vm-name

Nom de la machine virtuelle.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--context

Source qui a lancé l’attribution de configuration d’invité. Ex : Azure Policy.

--guest-configuration-configuration-parameter

Paramètres de configuration de la configuration invité.

Utilisation : --guest-configuration-configuration-parameter name=XX value=XX

nom : nom du paramètre de configuration. valeur : valeur du paramètre de configuration.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Paramètre de configuration de la configuration de l’invité.

Utilisation : --guest-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

mode configuration : spécifie la façon dont le gestionnaire de configuration local (LCM)applique réellement la configuration aux nœuds cibles. Les valeurs possibles sont ApplyOnly, ApplyAndMonitor et ApplyAndAutoCorrect. allow-module-overwrite : si true - les nouvelles configurations téléchargées à partir du service pull sont autorisées à remplacer les anciennes sur le nœud cible. Sinon, false action-after-reboot : spécifie ce qui se passe après un redémarrage pendant l’application d’une configuration. Les valeurs possibles sont ContinueConfiguration et StopConfiguration refresh-frequency-mins : intervalle de temps, en minutes, auquel le gestionnaire de configuration local vérifie un service d’extraction pour obtenir les configurations mises à jour. Cette valeur est ignorée si le gestionnaire de configuration local n’est pas configuré en mode collecteur. La valeur par défaut est 30. reboot-if-needed : définissez cette valeur sur true pour redémarrer automatiquement le nœud après une configuration nécessitant un redémarrage. Sinon, vous devrez redémarrer manuellement le nœud pour toute configuration qui l’exige. La valeur par défaut est false. Pour utiliser ce paramètre lorsqu’une condition de redémarrage est adoptée par autre chose que DSC (par exemple, Windows Installer), combinez ce paramètre avec le module xPendingReboot. configuration-mode-frequency-mins : fréquence à laquelle, en minutes, la configuration actuelle est vérifiée et appliquée. Cette propriété est ignorée si la propriété ConfigurationMode est définie sur ApplyOnly. La valeur par défaut est 15.

--guest-configuration-name

Nom de la configuration d’invité.

--guest-configuration-version

Version de la configuration d’invité.

--latest-assignment-report-assignment

Détails de configuration de l’attribution de configuration d’invité. Valeur attendue : json-string/@json-file.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--name

Nom de l’attribution de configuration d’invité.

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az guestconfig guest-configuration-assignment delete

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Supprimez une attribution de configuration d’invité.

az guestconfig guest-configuration-assignment delete [--ids]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Exemples

Supprimer une attribution de configuration d’invité

az guestconfig guest-configuration-assignment delete --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--name -n

Nom de l’attribution de configuration d’invité.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--vm-name

Nom de la machine virtuelle.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az guestconfig guest-configuration-assignment list

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertorier toutes les attributions de configuration d’invité pour une machine virtuelle.

az guestconfig guest-configuration-assignment list --resource-group
                                                   --vm-name

Exemples

Répertorier toutes les attributions de configuration d’invité pour une machine virtuelle

az guestconfig guest-configuration-assignment list --resource-group "myResourceGroupName" --vm-name "myVMName"

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--vm-name

Nom de la machine virtuelle.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az guestconfig guest-configuration-assignment show

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenez des informations sur une attribution de configuration d’invité.

az guestconfig guest-configuration-assignment show [--ids]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--vm-name]

Exemples

Obtenir une attribution de configuration d’invité

az guestconfig guest-configuration-assignment show --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--name -n

Nom de l’attribution de configuration d’invité.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--vm-name

Nom de la machine virtuelle.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az guestconfig guest-configuration-assignment update

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Crée une association entre une machine virtuelle et une configuration invité.

az guestconfig guest-configuration-assignment update [--context]
                                                     [--guest-configuration-assignment-name]
                                                     [--guest-configuration-configuration-parameter]
                                                     [--guest-configuration-configuration-setting]
                                                     [--guest-configuration-name]
                                                     [--guest-configuration-version]
                                                     [--ids]
                                                     [--latest-assignment-report-assignment]
                                                     [--location]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Exemples

Créer ou mettre à jour l’attribution de configuration d’invité

az guestconfig guest-configuration-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--context

Source qui a lancé l’attribution de configuration d’invité. Ex : Azure Policy.

--guest-configuration-assignment-name

Nom de l’attribution de configuration d’invité.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--guest-configuration-configuration-parameter

Paramètres de configuration de la configuration invité.

Utilisation : --guest-configuration-configuration-parameter name=XX value=XX

nom : nom du paramètre de configuration. valeur : valeur du paramètre de configuration.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Paramètre de configuration de la configuration de l’invité.

Utilisation : --guest-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

--guest-configuration-name

Nom de la configuration d’invité.

--guest-configuration-version

Version de la configuration d’invité.

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--latest-assignment-report-assignment

Détails de configuration de l’attribution de configuration d’invité. Valeur attendue : json-string/@json-file.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--name

Nom de l’attribution de configuration d’invité.

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--vm-name

Nom de la machine virtuelle.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az guestconfig guest-configuration-assignment wait

Expérimental

Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’attribution guest-configuration guestconfig soit remplie.

az guestconfig guest-configuration-assignment wait [--created]
                                                   [--custom]
                                                   [--deleted]
                                                   [--exists]
                                                   [--ids]
                                                   [--interval]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--timeout]
                                                   [--updated]
                                                   [--vm-name]

Exemples

Suspendez l’exécution de la ligne suivante du script CLI jusqu’à ce que l’attribution guest-configuration-assignment guestconfig soit correctement créée.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --created

Suspendez l’exécution de la ligne suivante du script CLI jusqu’à ce que l’attribution guest-configuration-assignment guestconfig soit correctement supprimée.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --deleted

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments

--deleted

Attendez la suppression.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--exists

Attendez que la ressource existe.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--interval

Intervalle d’interrogation en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	30

--name -n

Nom de l’attribution de configuration d’invité.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--timeout

Délai maximal d’attente en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	3600

--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--vm-name

Nom de la machine virtuelle.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

Commentaires

Cette page a-t-elle été utile ?

Partager via

az guestconfig guest-configuration-assignment

Commandes

az guestconfig guest-configuration-assignment create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az guestconfig guest-configuration-assignment delete

Exemples

Paramètres facultatifs

az guestconfig guest-configuration-assignment list

Exemples

Paramètres obligatoires

az guestconfig guest-configuration-assignment show

Exemples

Paramètres facultatifs

az guestconfig guest-configuration-assignment update

Exemples

Paramètres facultatifs

az guestconfig guest-configuration-assignment wait

Exemples

Paramètres facultatifs

Commentaires