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