Delen via

Set-AzVMDiagnosticsExtension

  • Referentie
Module:
Az.Compute

Hiermee configureert u de diagnostische Azure-extensie op een virtuele machine.

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>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De cmdlet Set-AzVMDiagnosticsExtension configureert de Diagnostische Azure-extensie op een virtuele machine.

Voorbeelden

Voorbeeld 1: Diagnostische gegevens inschakelen met behulp van een opslagaccount dat is opgegeven in een diagnostisch configuratiebestand

PS C:\> Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

Deze opdracht maakt gebruik van een diagnostisch configuratiebestand om diagnostische gegevens in te schakelen. Het bestand diagnostics_publicconfig.xml bevat de openbare XML-configuratie voor de extensie voor diagnostische gegevens, inclusief de naam van het opslagaccount waarnaar diagnostische gegevens worden verzonden. Het diagnostische opslagaccount moet zich in hetzelfde abonnement bevinden als de virtuele machine.

Voorbeeld 2: Diagnostische gegevens inschakelen met behulp van een opslagaccountnaam

PS C:\> Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

Met deze opdracht wordt de naam van het opslagaccount gebruikt om diagnostische gegevens in te schakelen. Als de diagnostische configuratie geen opslagaccountnaam opgeeft of als u de naam van het diagnostische opslagaccount wilt overschrijven die is opgegeven in het configuratiebestand, gebruikt u de parameter StorageAccountName . Het diagnostische opslagaccount moet zich in hetzelfde abonnement bevinden als de virtuele machine.

Voorbeeld 3: Diagnostische gegevens inschakelen met de naam en sleutel van het opslagaccount

PS C:\> Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

Deze opdracht maakt gebruik van de naam en sleutel van het opslagaccount om diagnostische gegevens in te schakelen. Als het opslagaccount voor diagnostische gegevens zich in een ander abonnement bevindt dan de virtuele machine, schakelt u het verzenden van diagnostische gegevens naar dat opslagaccount in door expliciet de naam en sleutel op te geven.

Parameters

-AutoUpgradeMinorVersion

Geeft aan of met deze cmdlet de Azure-gastagent de extensie automatisch kan bijwerken naar een nieuwere secundaire versie.

Type:Boolean
Position:10
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DiagnosticsConfigurationPath

Hiermee geeft u het pad van het configuratiebestand.

Type:String
Position:2
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:7
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een extensie.

Type:String
Aliases:ExtensionName
Position:8
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Type:String
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountEndpoint

Hiermee geeft u het eindpunt van het opslagaccount op.

Type:String
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

Hiermee geeft u de sleutel van het opslagaccount op.

Type:String
Position:4
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Hiermee geeft u de naam van het opslagaccount op.

Type:String
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageContext

Hiermee geeft u de Azure-opslagcontext op.

Type:IStorageContext
Position:6
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine. Als u de versie wilt ophalen, voert u de cmdlet Get-AzVMExtensionImage uit met de waarde Microsoft.Compute voor de parameter PublisherName en VMAccessAgent voor de parameter Type .

Type:String
Aliases:HandlerVersion, Version
Position:9
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Hiermee geeft u de naam van de virtuele machine waarop deze cmdlet werkt.

Type:String
Aliases:ResourceName
Position:1
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

PSAzureOperationResponse