az guestconfig guest-configuration-assignment
Remarque
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 commande az guestconfig guest-configuration-assignment . En savoir plus sur les extensions.
Ce groupe de commandes est expérimental et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus
Guestconfig guest-configuration-assignment.
Commandes
Nom | Description | Type | Statut |
---|---|---|---|
az guestconfig guest-configuration-assignment create |
Crée une association entre une machine virtuelle et une configuration invité. |
Extension | Expérimental |
az guestconfig guest-configuration-assignment delete |
Supprimez une attribution de configuration d’invité. |
Extension | Expérimental |
az guestconfig guest-configuration-assignment list |
Répertorier toutes les attributions de configuration d’invité pour une machine virtuelle. |
Extension | Expérimental |
az guestconfig guest-configuration-assignment show |
Obtenez des informations sur une attribution de configuration d’invité. |
Extension | Expérimental |
az guestconfig guest-configuration-assignment update |
Crée une association entre une machine virtuelle et une configuration invité. |
Extension | Expérimental |
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 | Expérimental |
az guestconfig guest-configuration-assignment create
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
Nom de l’attribution de configuration d’invité.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom de la machine virtuelle.
Paramètres facultatifs
Source qui a lancé l’attribution de configuration d’invité. Ex : Azure Policy.
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.
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 case activée un service d’extraction pour obtenir des configurations mises à jour. Cette valeur est ignorée si le LCM n’est pas configuré en mode d’extraction. 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 devez redémarrer manuellement le nœud. La valeur par défaut est false (Faux). Pour utiliser ce paramètre lorsqu’une condition de redémarrage est imposée par autre chose que DSC (par exemple Windows Installer), combinez ce paramètre avec le module xPendingReboot. configuration-mode-fréquence-mins : fréquence à laquelle, en minutes, la configuration actuelle est case activé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.
Nom de la configuration d’invité.
Version de la configuration d’invité.
Détails de configuration de l’attribution de configuration d’invité. Valeur attendue : json-string/@json-file.
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom de l’attribution de configuration d’invité.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az guestconfig guest-configuration-assignment delete
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
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 ».
Nom de l’attribution de configuration d’invité.
Ne pas attendre la fin de l’opération de longue durée.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Nom de la machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az guestconfig guest-configuration-assignment list
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom de la machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az guestconfig guest-configuration-assignment show
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
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 ».
Nom de l’attribution de configuration d’invité.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Nom de la machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az guestconfig guest-configuration-assignment update
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
Source qui a lancé l’attribution de configuration d’invité. Ex : Azure Policy.
Nom de l’attribution de configuration d’invité.
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.
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 case activée un service d’extraction pour obtenir des configurations mises à jour. Cette valeur est ignorée si le LCM n’est pas configuré en mode d’extraction. 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 devez redémarrer manuellement le nœud. La valeur par défaut est false (Faux). Pour utiliser ce paramètre lorsqu’une condition de redémarrage est imposée par autre chose que DSC (par exemple Windows Installer), combinez ce paramètre avec le module xPendingReboot. configuration-mode-fréquence-mins : fréquence à laquelle, en minutes, la configuration actuelle est case activé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.
Nom de la configuration d’invité.
Version de la configuration d’invité.
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 ».
Détails de configuration de l’attribution de configuration d’invité. Valeur attendue : json-string/@json-file.
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom de l’attribution de configuration d’invité.
Ne pas attendre la fin de l’opération de longue durée.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Nom de la machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az guestconfig guest-configuration-assignment wait
Le groupe de commandes « guestconfig guest-configuration-assignment » est expérimental et en cours de développement. Référence et niveaux 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
Attendez la création avec « provisioningState » sur « Succeeded ».
Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Attendez la suppression.
Attendez que la ressource existe.
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 ».
Intervalle d’interrogation en secondes.
Nom de l’attribution de configuration d’invité.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Délai maximal d’attente en secondes.
Attendez la mise à jour avec provisioningState sur « Réussi ».
Nom de la machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour