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 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-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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ExtensionName
Hiermee geeft u de extensienaam van de virtuele machine.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| 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 |
-PrivateConfigKey
Hiermee geeft u een persoonlijke configuratiesleutel.
| Type: | String |
| Position: | 10 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-PrivateConfigPath
Hiermee geeft u het privéconfiguratiepad op.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-PrivateConfiguration
Hiermee geeft u de privéconfiguratietekst op.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| 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 |
-PublicConfigKey
Hiermee geeft u de openbare configuratiesleutel.
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-PublicConfigPath
Hiermee geeft u het openbare configuratiepad.
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-PublicConfiguration
Hiermee geeft u de openbare configuratietekst.
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Publisher
Hiermee geeft u de uitgever van de extensie.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Uninstall
Geeft aan dat met deze cmdlet de resource-extensie van de virtuele machine wordt verwijderd.
| Type: | SwitchParameter |
| Position: | 8 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Version
Hiermee geeft u de extensieversie.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Vereist: | True |
| 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 |