Set-AzureVMExtension
Ustawia rozszerzenia zasobów dla maszyn wirtualnych.
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-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>] Opis
Polecenie cmdlet Set-AzureVMExtension ustawia rozszerzenia zasobów dla maszyn wirtualnych.
Przykłady
Przykład 1. Tworzenie maszyny wirtualnej z zastosowanymi rozszerzeniami zasobów
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;To polecenie tworzy maszynę wirtualną z zastosowanymi rozszerzeniami zasobów.
Parametry
-Disable
Wskazuje, że to polecenie cmdlet wyłącza stan rozszerzenia.
| Typ: | SwitchParameter |
| Position: | 7 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExtensionName
Określa nazwę rozszerzenia maszyny wirtualnej.
| Typ: | String |
| Position: | 1 |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ForceUpdate
Wskazuje, że to polecenie cmdlet ponownie stosuje konfigurację do rozszerzenia, gdy konfiguracja nie została zaktualizowana.
| Typ: | SwitchParameter |
| Position: | 11 |
| 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 |
-PrivateConfigKey
Określa prywatny klucz konfiguracji.
| Typ: | String |
| Position: | 10 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivateConfigPath
Określa prywatną ścieżkę konfiguracji.
| Typ: | String |
| Position: | 6 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivateConfiguration
Określa tekst konfiguracji prywatnej.
| Typ: | String |
| Position: | 6 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| 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 |
-PublicConfigKey
Określa klucz konfiguracji publicznej.
| Typ: | String |
| Position: | 9 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicConfigPath
Określa ścieżkę konfiguracji publicznej.
| Typ: | String |
| Position: | 5 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicConfiguration
Określa tekst konfiguracji publicznej.
| Typ: | String |
| Position: | 5 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Publisher
Określa wydawcę rozszerzenia.
| Typ: | String |
| Position: | 2 |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReferenceName
Określa nazwę odwołania rozszerzenia.
Jest to ciąg zdefiniowany przez użytkownika, który może służyć do odwoływania się do rozszerzenia. Należy określić je po dodaniu rozszerzenia 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: | 4 |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Uninstall
Wskazuje, że to polecenie cmdlet odinstalowuje rozszerzenie zasobu z maszyny wirtualnej.
| Typ: | SwitchParameter |
| Position: | 8 |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Version
Określa wersję rozszerzenia.
| Typ: | String |
| Position: | 3 |
| wartość domyślna: | None |
| Wymagane: | True |
| 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 |