Set-AzVMDiagnosticsExtension
Hiermee configureert u de Azure diagnostische extensie op een virtuele machine.
Syntax
Default (Standaard)
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>]
Description
De cmdlet Set-AzVMDiagnosticsExtension configureert de Azure diagnostische extensie op een virtuele machine.
Voorbeelden
Voorbeeld 1: Diagnostische gegevens inschakelen met behulp van een opslagaccount dat is opgegeven in een diagnostisch configuratiebestand
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 diagnostische extensie, 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
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
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
Hiermee wordt aangegeven of met deze cmdlet de Azure gastagent de extensie automatisch kan bijwerken naar een nieuwere secundaire versie.
Parametereigenschappen
Type: Boolean
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 10
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Parametereigenschappen
Type: IAzureContextContainer
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: AzContext, AzureRmContext, AzureCredential
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-DiagnosticsConfigurationPath
Hiermee geeft u het pad van het configuratiebestand.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 2
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Location
Hiermee geeft u de locatie van de virtuele machine.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 7
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Name
Hiermee geeft u de naam van een extensie.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: ExtensionName
Parametersets
(All)
Position: 8
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-NoWait
Start de bewerking en retourneert onmiddellijk voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep van de virtuele machine.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 0
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-StorageAccountEndpoint
Hiermee geeft u het eindpunt van het opslagaccount op.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 5
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-StorageAccountKey
Hiermee geeft u de sleutel van het opslagaccount op.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 4
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-StorageAccountName
Hiermee geeft u de naam van het opslagaccount op.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 3
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-StorageContext
Hiermee geeft u de Azure opslagcontext.
Parametereigenschappen
Type: IStorageContext
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 6
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TypeHandlerVersion
Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine.
Als u de versie wilt verkrijgen, voert u de Get-AzVMExtensionImage cmdlet uit met de waarde Microsoft.Compute voor de parameter PublisherName en VMAccessAgent voor de parameter Type .
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: HandlerVersion, Versie
Parametersets
(All)
Position: 9
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-VMName
Hiermee geeft u de naam van de virtuele machine waarop deze cmdlet werkt.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: ResourceNaam
Parametersets
(All)
Position: 1
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Uitvoerwaarden