Set-AzureVMDiagnosticsExtension
Configure l’extension Diagnostics Azure sur une machine virtuelle.
Remarque
Les applets de commande référencées dans cette documentation concernent la gestion des ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.
Syntax
Set-AzureVMDiagnosticsExtension
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[[-Version] <String>]
[-Disable]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureVMDiagnosticsExtension
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[[-Version] <String>]
[-Disable]
[[-ReferenceName] <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureVMDiagnosticsExtension configure l’extension Microsoft Diagnostics Azure sur une machine virtuelle.
Exemples
Exemple 1 : Créer une machine virtuelle avec l’extension Diagnostics Azure appliquée
PS C:\> $VM = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $VMImage
PS C:\> $VM = Add-AzureProvisioningConfig -VM $VM -AdminUsername $Username -Password $Password -Windows
PS C:\> $VM = Set-AzureVMDiagnosticsExtension -DiagnosticsConfigurationPath $Config_Path -Version "1.*" -VM $VM -StorageContext $Storage_Context
PS C:\> New-AzureVM -Location $Location -ServiceName $Service_Name -VM $VM
Ces commandes activent l’extension Diagnostics Azure sur une machine virtuelle.
Exemple 2 : Activer une extension Diagnostics Azure sur une machine virtuelle existante
PS C:\> $VM = Get-AzureVM -ServiceName $Service_Name -Name $VM_Name
PS C:\> $VM_Update = Set-AzureVMDiagnosticsExtension -DiagnosticsConfigurationPath $Config_Path -Version "1.*" -VM $VM -StorageContext $Storage_Context
PS C:\> Update-AzureVM -ServiceName $Service_Name -Name $VM_Name -VM $VM_Update.VM
La première commande utilise l’applet de commande Get-AzureVM pour obtenir une machine virtuelle.
La deuxième commande utilise l’applet de commande Set-AzureVMDiagnosticsExtension pour mettre à jour la configuration de la machine virtuelle afin d’inclure l’extension Diagnostics Azure.
La commande finale applique la configuration mise à jour à la machine virtuelle.
Paramètres
-DiagnosticsConfigurationPath
Spécifie un chemin d’accès pour la configuration des diagnostics.
Type: | String |
Position: | 0 |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Indique que cette applet de commande désactive l’extension diagnostics sur la machine virtuelle.
Type: | SwitchParameter |
Position: | 6 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Spécifie la façon dont cette applet de commande répond à un événement d’information.
Les valeurs valides pour ce paramètre sont :
- Continuer
- Ignorer
- Demander
- SilentlyContinue
- Arrêter
- Suspendre
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Spécifie une variable d’informations.
Type: | String |
Aliases: | iv |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.
Type: | AzureSMProfile |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReferenceName
Spécifie le nom de référence de l’extension diagnostics.
Type: | String |
Position: | 7 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountEndpoint
Spécifie un point de terminaison de compte de stockage.
Type: | String |
Position: | 3 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountKey
Spécifie une clé de compte de stockage.
Type: | String |
Position: | 2 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Spécifie un nom de compte de stockage.
Type: | String |
Position: | 1 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageContext
Spécifie un contexte de stockage Azure.
Type: | AzureStorageContext |
Position: | 4 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Spécifie la version de l’extension sous forme de chaîne.
Type: | String |
Position: | 5 |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Spécifie l’objet de machine virtuelle persistante.
Type: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |