Freigeben über

Set-AzVMDiagnosticsExtension

Modul:
Az.Compute Module

Konfiguriert die Azure-Diagnoseerweiterung auf einem virtuellen Computer.

Syntax

Default (Standard) 

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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:10
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DiagnosticsConfigurationPath

Gibt den Pfad der Konfigurationsdatei an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Location

Gibt den Speicherort des virtuellen Computers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:7
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen einer Erweiterung an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ExtensionName

Parametersätze

(All)
Position:8
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StorageAccountEndpoint

Gibt den Endpunkt des Speicherkontos an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StorageAccountKey

Gibt den Speicherkontoschlüssel an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StorageAccountName

Gibt den Namen des Speicherkontos an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StorageContext

Gibt den Azure-Speicherkontext an.

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:6
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:HandlerVersion, Version

Parametersätze

(All)
Position:9
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-VMName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcenname

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

IStorageContext

Boolean

Ausgaben

PSAzureOperationResponse