Set-AzureVMCustomScriptExtension
Legt Informationen für eine benutzerdefinierte Skripterweiterung für einen virtuellen Azure-Computer fest.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-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-AzureVMCustomScriptExtension
[[-ReferenceName] <String>]
[[-Version] <String>]
[-ContainerName] <String>
[-FileName] <String[]>
[[-StorageAccountName] <String>]
[[-StorageEndpointSuffix] <String>]
[[-StorageAccountKey] <String>]
[[-Run] <String>]
[[-Argument] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMCustomScriptExtension
[[-ReferenceName] <String>]
[[-Version] <String>]
[-Disable]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMCustomScriptExtension
[[-ReferenceName] <String>]
[[-Version] <String>]
[-Uninstall]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMCustomScriptExtension
[[-ReferenceName] <String>]
[[-Version] <String>]
[[-FileUri] <String[]>]
[-Run] <String>
[[-Argument] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-AzureVMCustomScriptExtension legt Informationen für eine benutzerdefinierte Skripterweiterung für einen virtuellen Azure-Computer fest.
Beispiele
Beispiel 1: Festlegen von Informationen für eine benutzerdefinierte Skripterweiterung eines virtuellen Computers
PS C:\> $VM = Set-AzureVMCustomScriptExtension -VM $VM -ContainerName "Container01" -FileName "script1.ps1","script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> New-AzureVM -Location "West US" -ServiceName $SVC -VM $VM;Dieser Befehl legt Informationen für eine benutzerdefinierte Skripterweiterung eines virtuellen Computers fest.
Beispiel 2: Festlegen von Informationen für eine benutzerdefinierte Skripterweiterung eines virtuellen Computers mithilfe eines Dateipfads
PS C:\> Set-AzureVMCustomScriptExtension -VM $VM -FileUri "http://www.blob.core.contoso.net/bar/script1.ps1","http://www.blob.core.contoso.net/baz/script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> Update-AzureVM -ServiceName $SVC -Name $Name -VM VM;Mit diesem Befehl werden Informationen für eine benutzerdefinierte Skripterweiterung eines virtuellen Computers mithilfe mehrerer Datei-URLs festgelegt.
Parameter
-Argument
Gibt eine Zeichenfolge an, die ein Argument bereitstellt, das dieses Cmdlet auf dem virtuellen Computer ausführt.
| Typ: | String |
| Position: | 8 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ContainerName
Gibt den Containernamen innerhalb des Speicherkontos an.
| Typ: | String |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Disable
Gibt an, dass dieses Cmdlet den Erweiterungsstatus deaktiviert.
| Typ: | SwitchParameter |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-FileName
Gibt ein Zeichenfolgenarray an, das die Namen der BLOB-Dateien im angegebenen Container enthält.
| Typ: | String[] |
| Position: | 3 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-FileUri
Gibt ein Zeichenfolgenarray an, das die URLs der BLOB-Dateien enthält.
| Typ: | String[] |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ForceUpdate
Gibt an, dass dieses Cmdlet eine Konfiguration auf eine Erweiterung erneut anwendet, wenn die Konfiguration nicht aktualisiert wurde.
| Typ: | SwitchParameter |
| Position: | 9 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Fortsetzen
- Ignorieren
- Inquire
- SilentlyContinue
- Beenden
- Angehalten
| Typ: | ActionPreference |
| Aliase: | infa |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InformationVariable
Gibt eine Informationsvariable an.
| Typ: | String |
| Aliase: | iv |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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 |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ReferenceName
Gibt den Verweisnamen für die Erweiterung an.
Dieser Parameter ist eine benutzerdefinierte Zeichenfolge, die verwendet werden kann, um auf eine Erweiterung zu verweisen. Sie wird angegeben, 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: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Run
Gibt den Befehl an, den dieses Cmdlet von der Erweiterung auf dem virtuellen Computer ausführt. Nur "powershell.exe" wird unterstützt.
| Typ: | String |
| Aliase: | RunFile, Command |
| Position: | 7 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageAccountKey
Gibt den Speicherkontoschlüssel an.
| Typ: | String |
| Position: | 6 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageAccountName
Gibt den Namen des Speicherkontos im aktuellen Abonnement an.
| Typ: | String |
| Position: | 4 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageEndpointSuffix
Gibt den Speicherdienstendpunkt an.
| Typ: | String |
| Position: | 5 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Uninstall
Gibt an, dass dieses Cmdlet die benutzerdefinierte Skripterweiterung vom virtuellen Computer deinstalliert.
| Typ: | SwitchParameter |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Version
Gibt die Version der benutzerdefinierten Skripterweiterung an.
| Typ: | String |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VM
Gibt das objekt des beständigen virtuellen Computers an.
| Typ: | IPersistentVM |
| Aliase: | InputObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |