Set-AzureVMExtension
Legt Ressourcenerweiterungen für virtuelle Computer fest.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
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>]
Beschreibung
Das Cmdlet Set-AzureVMExtension legt Ressourcenerweiterungen für virtuelle Computer fest.
Beispiele
Beispiel 1: Erstellen eines virtuellen Computers mit angewendeten Ressourcenerweiterungen
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;
Dieser Befehl erstellt einen virtuellen Computer mit angewendeten Ressourcenerweiterungen.
Parameter
-Disable
Gibt an, dass dieses Cmdlet den Erweiterungsstatus deaktiviert.
Typ: | SwitchParameter |
Position: | 7 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionName
Gibt den Erweiterungsnamen des virtuellen Computers an.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ForceUpdate
Gibt an, dass dieses Cmdlet eine Konfiguration auf eine Erweiterung erneut anwendet, wenn die Konfiguration nicht aktualisiert wurde.
Typ: | SwitchParameter |
Position: | 11 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Weiter
- Ignorieren
- Inquire
- SilentlyContinue
- Beenden
- Angehalten
Typ: | ActionPreference |
Aliases: | infa |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Typ: | String |
Aliases: | iv |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateConfigKey
Gibt einen privaten Konfigurationsschlüssel an.
Typ: | String |
Position: | 10 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivateConfigPath
Gibt den privaten Konfigurationspfad an.
Typ: | String |
Position: | 6 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivateConfiguration
Gibt den Text für die private Konfiguration an.
Typ: | String |
Position: | 6 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Typ: | AzureSMProfile |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicConfigKey
Gibt den öffentlichen Konfigurationsschlüssel an.
Typ: | String |
Position: | 9 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfigPath
Gibt den öffentlichen Konfigurationspfad an.
Typ: | String |
Position: | 5 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfiguration
Gibt den öffentlichen Konfigurationstext an.
Typ: | String |
Position: | 5 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Publisher
Gibt den Herausgeber der Erweiterung an.
Typ: | String |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReferenceName
Gibt den Verweisnamen der Erweiterung an.
Dies ist eine benutzerdefinierte Zeichenfolge, die verwendet werden kann, um auf eine Erweiterung zu verweisen. Sie müssen sie angeben, wenn die Erweiterung zum ersten Mal dem virtuellen Computer hinzugefügt wird. Bei nachfolgenden Updates müssen Sie beim Aktualisieren der Erweiterung den zuvor verwendeten Verweisnamen angeben. Der einer Erweiterung zugewiesene Verweisname wird mithilfe des Cmdlets "Get-AzureVM " zurückgegeben.
Typ: | String |
Position: | 4 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Uninstall
Gibt an, dass dieses Cmdlet die Ressourcenerweiterung vom virtuellen Computer deinstalliert.
Typ: | SwitchParameter |
Position: | 8 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Gibt die Erweiterungsversion an.
Typ: | String |
Position: | 3 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Gibt das objekt des beständigen virtuellen Computers an.
Typ: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |