Set-AzVMDiagnosticsExtension

  • Référence
Module:
Az.Compute

Configure l’extension diagnostics Azure sur une machine virtuelle.

Syntax

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 diagnostics spécifié dans le fichier de configuration, utilisez le paramètre Stockage AccountName. 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiagnosticsConfigurationPath

Spécifie le chemin d’accès du fichier de configuration.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

Spécifie l’emplacement de la machine virtuelle.

Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie le nom d’une extension.

Type:String
Aliases:ExtensionName
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Spécifie le nom du groupe de ressources de la machine virtuelle.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountEndpoint

Spécifie le point de terminaison du compte de stockage.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

Spécifie la clé du compte de stockage.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

spécifie le nom du compte de stockage.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageContext

Spécifie le contexte de stockage Azure.

Type:IStorageContext
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:HandlerVersion, Version
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Spécifie le nom de la machine virtuelle sur laquelle cette applet de commande fonctionne.

Type:String
Aliases:ResourceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

IStorageContext

Boolean

Sorties

PSAzureOperationResponse