Set-AzureRMVMDiagnosticsExtension
Configure l’extension diagnostics Azure sur une machine virtuelle.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Set-AzureRMVMDiagnosticsExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <IStorageContext>]
[[-Location] <String>]
[[-Name] <String>]
[[-TypeHandlerVersion] <String>]
[[-AutoUpgradeMinorVersion] <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureRmVMDiagnosticsExtension configure l’extension diagnostics Azure sur une machine virtuelle.
Exemples
Exemple 1 : Activer les diagnostics à l’aide d’un compte de stockage spécifié dans un fichier de configuration de diagnostics
PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"
Cette commande utilise un fichier de configuration de diagnostics pour activer les diagnostics. Le fichier diagnostics_publicconfig.xml contient la configuration XML publique pour l’extension de diagnostics, y compris le nom du compte de stockage auquel les données de diagnostic seront envoyées. Le compte de stockage de diagnostics doit se trouver dans le même abonnement que la machine virtuelle.
Exemple 2 : Activer les diagnostics à l’aide d’un nom de compte de stockage
PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"
Cette commande utilise le nom du compte de stockage pour activer les diagnostics. Si la configuration des diagnostics ne spécifie pas de nom de compte de stockage ou si vous souhaitez remplacer le nom du compte de stockage de diagnostic spécifié dans le fichier de configuration, utilisez le paramètre StorageAccountName . Le compte de stockage de diagnostics doit se trouver dans le même abonnement que la machine virtuelle.
Exemple 3 : Activer les diagnostics à l’aide du nom et de la clé du compte de stockage
PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key
Cette commande utilise le nom et la clé du compte de stockage pour activer les diagnostics. Si le compte de stockage de diagnostics se trouve dans un autre abonnement que la machine virtuelle, activez l’envoi de données de diagnostic à ce compte de stockage en spécifiant explicitement son nom et sa clé.
Paramètres
-AutoUpgradeMinorVersion
Indique si cette applet de commande permet à l’agent invité Azure de mettre automatiquement à jour l’extension vers une version mineure plus récente.
Type: | Boolean |
Position: | 10 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DiagnosticsConfigurationPath
Spécifie le chemin d’accès du fichier de configuration.
Type: | String |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Location
Spécifie l’emplacement de la machine virtuelle.
Type: | String |
Position: | 7 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Name
Spécifie le nom d’une extension.
Type: | String |
Alias: | ExtensionName |
Position: | 8 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources de la machine virtuelle.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-StorageAccountEndpoint
Spécifie le point de terminaison du compte de stockage.
Type: | String |
Position: | 5 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-StorageAccountKey
Spécifie la clé du compte de stockage.
Type: | String |
Position: | 4 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-StorageAccountName
spécifie le nom du compte de stockage.
Type: | String |
Position: | 3 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-StorageContext
Spécifie le contexte de stockage Azure.
Type: | IStorageContext |
Position: | 6 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-TypeHandlerVersion
Spécifie la version de l’extension à utiliser pour cette machine virtuelle. Pour obtenir la version, exécutez l’applet de commande Get-AzureRmVMExtensionImage avec la valeur Microsoft.Compute pour le paramètre PublisherName et VMAccessAgent pour le paramètre Type .
Type: | String |
Alias: | HandlerVersion, Version |
Position: | 9 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VMName
Spécifie le nom de la machine virtuelle sur laquelle cette applet de commande fonctionne.
Type: | String |
Alias: | ResourceName |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |