Partager via


Set-AzVMDiagnosticsExtension

Configure l’extension diagnostics Azure sur une machine virtuelle.

Syntaxe

Set-AzVMDiagnosticsExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-DiagnosticsConfigurationPath] <String>
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <IStorageContext>]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzVMDiagnosticsExtension 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

Set-AzVMDiagnosticsExtension -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

Set-AzVMDiagnosticsExtension -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

Set-AzVMDiagnosticsExtension -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:AzContext, 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

-NoWait

Démarre l’opération et retourne immédiatement, avant la fin de l’opération. Pour déterminer si l’opération a bien été effectuée, utilisez un autre mécanisme.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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-AzVMExtensionImage 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

Entrées

String

IStorageContext

Boolean

Sorties

PSAzureOperationResponse