Freigeben über

Set-AzVMDiagnosticsExtension

  • Referenz
Modul:
Az.Compute

Konfiguriert die Azure-Diagnoseerweiterung 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-Diagnoseerweiterung auf einem virtuellen Computer.

Beispiele

Beispiel 1: Aktivieren der Diagnose mithilfe eines speicherkontos, das in einer Diagnosekonfigurationsdatei angegeben ist

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

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

Beispiel 2: Aktivieren der Diagnose mithilfe eines Speicherkontonamens

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

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

Beispiel 3: Aktivieren der 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 die Diagnose zu aktivieren. Wenn sich das Diagnosespeicherkonto in einem anderen Abonnement als der virtuelle Computer befindet, aktivieren Sie das Senden von Diagnosedaten 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.

Typ:Boolean
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DiagnosticsConfigurationPath

Gibt den Pfad der Konfigurationsdatei an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Gibt den Speicherort des virtuellen Computers an.

Typ:String
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen einer Erweiterung an.

Typ:String
Aliase:ExtensionName
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountEndpoint

Gibt den Endpunkt des Speicherkontos an.

Typ:String
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountKey

Gibt den Speicherkontoschlüssel an.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountName

Gibt den Speicherkontonamen an.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageContext

Gibt den Azure-Speicherkontext an.

Typ:IStorageContext
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String
Aliase:HandlerVersion, Version
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMName

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

Typ:String
Aliase:ResourceName
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

IStorageContext

Boolean

Ausgaben

PSAzureOperationResponse