Freigeben über

Set-AzVMDiagnosticsExtension

  • Referenz
Modul:
Az.Compute

Konfiguriert die Azure Diagnose-Erweiterung auf einem virtuellen Computer.

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>]

Beschreibung

Das Cmdlet Set-AzVMDiagnosticsExtension konfiguriert die Azure Diagnose-Erweiterung auf einem virtuellen Computer.

Beispiele

Beispiel 1: Aktivieren von Diagnose mithilfe eines speicherkontos, das in einer Diagnose Konfigurationsdatei angegeben ist

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

Dieser Befehl verwendet eine Diagnose Konfigurationsdatei, um Diagnose zu aktivieren. Die Datei Diagnose_publicconfig.xml enthält die öffentliche XML-Konfiguration für die Diagnose Erweiterung, einschließlich des Namens des Speicherkontos, an das Diagnose Daten gesendet werden. Das Diagnose Speicherkonto muss sich im selben Abonnement wie der virtuelle Computer befinden.

Beispiel 2: Aktivieren von Diagnose mithilfe eines Speicherkontonamens

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

Dieser Befehl verwendet den Namen des Speicherkontos, um Diagnose zu aktivieren. Wenn die Diagnose-Konfiguration keinen Speicherkontonamen angibt oder wenn Sie den in der Konfigurationsdatei angegebenen namen des Diagnose Speicherkontos außer Kraft setzen möchten, verwenden Sie den Parameter "StorageAccountName". Das Diagnose Speicherkonto muss sich im selben Abonnement wie der virtuelle Computer befinden.

Beispiel 3: Aktivieren von Diagnose mithilfe des Speicherkontonamens und des Schlüssels

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

Dieser Befehl verwendet den Namen und den Schlüssel des Speicherkontos, um Diagnose zu aktivieren. Wenn sich das Diagnose Speicherkonto in einem anderen Abonnement befindet als der virtuelle Computer, aktivieren Sie das Senden von Diagnose Daten an dieses Speicherkonto, indem Sie explizit den Namen und den Schlüssel angeben.

Parameter

-AutoUpgradeMinorVersion

Gibt an, ob mit diesem Cmdlet der Azure-Gast-Agent die Erweiterung automatisch auf eine neuere Nebenversion aktualisieren kann.

Type:Boolean
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-DiagnosticsConfigurationPath

Gibt den Pfad der Konfigurationsdatei an.

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

-Location

Gibt den Speicherort des virtuellen Computers an.

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

-Name

Gibt den Namen einer Erweiterung an.

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

-NoWait

Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Um festzustellen, ob der Vorgang erfolgreich abgeschlossen wurde, verwenden Sie einen anderen Mechanismus.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-StorageAccountEndpoint

Gibt den Endpunkt des Speicherkontos an.

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

-StorageAccountKey

Gibt den Speicherkontoschlüssel an.

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

-StorageAccountName

Gibt den Speicherkontonamen an.

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

-StorageContext

Gibt den Azure-Speicherkontext an.

Type:IStorageContext
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Gibt die Version der Erweiterung an, die für diesen virtuellen Computer verwendet werden soll. Führen Sie zum Abrufen der Version das Cmdlet "Get-AzVMExtensionImage" mit dem Wert "Microsoft.Compute" für den Parameter "PublisherName " und "VMAccessAgent" für den Parameter "Type " aus.

Type:String
Aliases:HandlerVersion, Version
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Gibt den Namen des virtuellen Computers an, auf dem dieses Cmdlet ausgeführt wird.

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

Eingaben

String

IStorageContext

Boolean

Ausgaben

PSAzureOperationResponse