Set-AzureVMCustomScriptExtension
Ustawia informacje dotyczące rozszerzenia niestandardowego skryptu maszyny wirtualnej platformy Azure.
Uwaga
Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
Składnia
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>]
Opis
Polecenie cmdlet Set-AzureVMCustomScriptExtension ustawia informacje dotyczące rozszerzenia niestandardowego skryptu maszyny wirtualnej platformy Azure.
Przykłady
Przykład 1. Ustawianie informacji dla niestandardowego rozszerzenia skryptu maszyny wirtualnej
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;
To polecenie ustawia informacje dotyczące rozszerzenia niestandardowego skryptu maszyny wirtualnej.
Przykład 2. Ustawianie informacji dla niestandardowego rozszerzenia skryptu maszyny wirtualnej przy użyciu ścieżki pliku
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;
To polecenie ustawia informacje dotyczące rozszerzenia niestandardowego skryptu maszyny wirtualnej przy użyciu wielu adresów URL plików.
Parametry
-Argument
Określa ciąg, który dostarcza argument, który to polecenie cmdlet jest uruchamiane na maszynie wirtualnej.
Typ: | String |
Position: | 8 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerName
Określa nazwę kontenera na koncie magazynu.
Typ: | String |
Position: | 2 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Disable
Wskazuje, że to polecenie cmdlet wyłącza stan rozszerzenia.
Typ: | SwitchParameter |
Position: | 2 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FileName
Określa tablicę ciągów zawierającą nazwy plików obiektów blob w określonym kontenerze.
Typ: | String[] |
Position: | 3 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FileUri
Określa tablicę ciągów zawierającą adresy URL plików obiektów blob.
Typ: | String[] |
Position: | 2 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ForceUpdate
Wskazuje, że to polecenie cmdlet ponownie zastosuj konfigurację do rozszerzenia, gdy konfiguracja nie została zaktualizowana.
Typ: | SwitchParameter |
Position: | 9 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.
Dopuszczalne wartości tego parametru to:
- Kontynuuj
- Ignoruj
- Zapytać
- SilentlyContinue
- Zatrzymaj
- Wstrzymanie
Typ: | ActionPreference |
Aliases: | infa |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Określa zmienną informacyjną.
Typ: | String |
Aliases: | iv |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.
Typ: | AzureSMProfile |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReferenceName
Określa nazwę odwołania dla rozszerzenia.
Ten parametr jest ciągiem zdefiniowanym przez użytkownika, który może służyć do odwoływania się do rozszerzenia. Jest on określany, gdy rozszerzenie jest dodawane do maszyny wirtualnej po raz pierwszy. W przypadku kolejnych aktualizacji należy określić wcześniej używaną nazwę odwołania podczas aktualizowania rozszerzenia. Nazwa ReferenceName przypisana do rozszerzenia jest zwracana przy użyciu polecenia cmdlet Get-AzureVM .
Typ: | String |
Position: | 0 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Run
Określa polecenie, które to polecenie cmdlet jest uruchamiane przez rozszerzenie na maszynie wirtualnej. Obsługiwane są tylko "powershell.exe".
Typ: | String |
Aliases: | RunFile, Command |
Position: | 7 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountKey
Określa klucz konta magazynu
Typ: | String |
Position: | 6 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Określa nazwę konta magazynu w bieżącej subskrypcji.
Typ: | String |
Position: | 4 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageEndpointSuffix
Określa punkt końcowy usługi magazynu.
Typ: | String |
Position: | 5 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Uninstall
Wskazuje, że to polecenie cmdlet odinstalowuje rozszerzenie niestandardowego skryptu z maszyny wirtualnej.
Typ: | SwitchParameter |
Position: | 2 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Określa wersję rozszerzenia niestandardowego skryptu.
Typ: | String |
Position: | 1 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Określa trwały obiekt maszyny wirtualnej.
Typ: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |