Delen via


Set-AzVMBginfoExtension

Hiermee voegt u de BGInfo-extensie toe aan een virtuele machine.

Syntaxis

Set-AzVMBginfoExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzVMBGInfoExtension voegt de BGInfo-extensie toe aan een virtuele machine.

Voorbeelden

Voorbeeld 1: De BGInfo-extensie voor een virtuele machine toevoegen

Set-AzVMBgInfoExtension -ResourceGroupName "ContosoRG" -VMName "ContosoVM" -Name "ExtensionName" -TypeHandlerVersion "2.1" -Location "West Europe"

Met deze opdracht wordt de BGInfo-extensie toegevoegd aan de virtuele machine met de naam ContosoVM. Met de opdracht geeft u de resourcegroep en locatie van de virtuele machine op. Met de opdracht geeft u de naam en versie van de extensie op.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableAutoUpgradeMinorVersion

Geeft aan dat deze cmdlet voorkomt dat de Azure-gastagent de extensie automatisch bijwerkt naar een nieuwere secundaire versie. Met deze cmdlet kan de gastagent de extensie standaard bijwerken.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ForceRerun

Hiermee geeft u op dat de extensie opnieuw moet worden uitgevoerd met dezelfde openbare of beveiligde instellingen. De waarde kan elke tekenreeks zijn die verschilt van de huidige waarde. Als forceUpdateTag niet wordt gewijzigd, worden updates voor openbare of beveiligde instellingen nog steeds toegepast door de handler.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de BGInfo-extensie die met deze cmdlet wordt toegevoegd aan een virtuele machine.

Type:String
Aliassen:ExtensionName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep van de virtuele machine waaraan deze cmdlet een extensie toevoegt.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TypeHandlerVersion

Hiermee geeft u de versie op van de extensie die met deze cmdlet wordt toegevoegd aan de virtuele machine.

Type:String
Aliassen:HandlerVersion, Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

Hiermee geeft u de naam op van de virtuele machine waaraan deze cmdlet de BGInfo-extensie toevoegt.

Type:String
Aliassen:ResourceName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSAzureOperationResponse