Delen via


Set-AzureVMExtension

Hiermee stelt u resource-extensies in voor virtuele machines.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

Syntax

Set-AzureVMExtension
   [-ExtensionName] <String>
   [-Publisher] <String>
   [-Version] <String>
   [[-ReferenceName] <String>]
   [[-PublicConfiguration] <String>]
   [[-PrivateConfiguration] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ExtensionName] <String>
   [-Publisher] <String>
   [-Version] <String>
   [[-ReferenceName] <String>]
   [[-PublicConfigPath] <String>]
   [[-PrivateConfigPath] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ReferenceName] <String>
   [[-PublicConfiguration] <String>]
   [[-PrivateConfiguration] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ReferenceName] <String>
   [[-PublicConfigPath] <String>]
   [[-PrivateConfigPath] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Met de cmdlet Set-AzureVMExtension worden resource-extensies ingesteld voor virtuele machines.

Voorbeelden

Voorbeeld 1: Een virtuele machine maken waarop resource-extensies zijn toegepast

PS C:\> $X = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $IMG;$X = Add-AzureProvisioningConfig -VM $X -Password $PWD -AdminUsername $USR -Windows;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext1 -Publisher $Publisher -Version $VER -PublicConfiguration $P1 -PrivateConfiguration $P2;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext2 -Publisher $Publisher -Version $VER -PublicConfiguration $P3 -PrivateConfiguration $P4;New-AzureVM -Location $LOC -ServiceName $SVC -VM $X;

Met deze opdracht maakt u een virtuele machine waarop resource-extensies zijn toegepast.

Parameters

-Disable

Geeft aan dat deze cmdlet de extensiestatus uitschakelt.

Type:SwitchParameter
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionName

Hiermee geeft u de extensienaam van de virtuele machine.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ForceUpdate

Geeft aan dat deze cmdlet een configuratie opnieuw toepast op een extensie wanneer de configuratie niet is bijgewerkt.

Type:SwitchParameter
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

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

De acceptabele waarden voor deze parameter zijn:

  • Doorgaan
  • Negeren
  • Informeren
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateConfigKey

Hiermee geeft u een persoonlijke configuratiesleutel.

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PrivateConfigPath

Hiermee geeft u het privéconfiguratiepad op.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PrivateConfiguration

Hiermee geeft u de privéconfiguratietekst op.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicConfigKey

Hiermee geeft u de openbare configuratiesleutel.

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicConfigPath

Hiermee geeft u het openbare configuratiepad.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicConfiguration

Hiermee geeft u de openbare configuratietekst.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Publisher

Hiermee geeft u de uitgever van de extensie.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReferenceName

Hiermee geeft u de verwijzingsnaam van de extensie.

Dit is een door de gebruiker gedefinieerde tekenreeks die kan worden gebruikt om te verwijzen naar een extensie. U moet deze opgeven wanneer de extensie voor het eerst wordt toegevoegd aan de virtuele machine. Voor volgende updates moet u de eerder gebruikte referentienaam opgeven tijdens het bijwerken van de extensie. De ReferenceName die is toegewezen aan een extensie, wordt geretourneerd met behulp van de Get-AzureVM-cmdlet .

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Uninstall

Geeft aan dat met deze cmdlet de resource-extensie van de virtuele machine wordt verwijderd.

Type:SwitchParameter
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Hiermee geeft u de extensieversie.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VM

Hiermee geeft u het permanente virtuele-machineobject.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False