Delen via


Set-AzureVMBGInfoExtension

Hiermee stelt u de BGInfo-extensie voor een virtuele machine in.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

Set-AzureVMBGInfoExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMBGInfoExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

De cmdlet Set-AzureVMBGInfoExtension stelt de BGInfo-extensie voor een virtuele machine in.

Voorbeelden

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

PS C:\> Set-AzureVMBGInfoExtension -VM $VM

Met deze opdracht stelt u de BGInfo-extensie voor de opgegeven virtuele machine in zoals opgeslagen in de variabele $VM.

Parameters

-Disable

Geeft aan dat deze cmdlet de extensiestatus uitschakelt.

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

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

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

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

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

-ReferenceName

Hiermee geeft u de verwijzingsnaam van de BGInfo-extensie.

Deze parameter is een door de gebruiker gedefinieerde tekenreeks die kan worden gebruikt om te verwijzen naar een extensie. Deze wordt opgegeven wanneer de extensie voor het eerst wordt toegevoegd aan de virtuele machine. U kunt de eerder gebruikte referentienaam opgeven tijdens het bijwerken van de extensie.

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

-Uninstall

Geeft aan dat met deze cmdlet de BGInfo-extensie wordt verwijderd.

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

-Version

Hiermee geeft u de versie van de BGInfo-extensie.

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

-VM

Hiermee geeft u het permanente virtuele-machineobject.

Type:IPersistentVM
Aliassen:InputObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False