Set-AzureRMVMDiagnosticsExtension
Hiermee configureert u de diagnostische Azure-extensie op een virtuele machine.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntax
Set-AzureRMVMDiagnosticsExtension
[-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-AzureRmVMDiagnosticsExtension 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-AzureRmVMDiagnosticsExtension -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-AzureRmVMDiagnosticsExtension -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-AzureRmVMDiagnosticsExtension -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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiagnosticsConfigurationPath
Hiermee geeft u het pad van het configuratiebestand.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Hiermee geeft u de locatie van de virtuele machine.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam van een extensie.
Type: | String |
Aliases: | ExtensionName |
Position: | 8 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountEndpoint
Hiermee geeft u het eindpunt van het opslagaccount op.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountKey
Hiermee geeft u de sleutel van het opslagaccount op.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Hiermee geeft u de naam van het opslagaccount op.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageContext
Hiermee geeft u de Azure-opslagcontext op.
Type: | IStorageContext |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TypeHandlerVersion
Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine. Voer de cmdlet Get-AzureRmVMExtensionImage uit met de waarde Microsoft.Compute voor de parameter PublisherName en VMAccessAgent voor de parameter Type om de versie te verkrijgen.
Type: | String |
Aliases: | HandlerVersion, Version |
Position: | 9 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |