Update-AzureVMImage
Aktualizuje etykietę obrazu systemu operacyjnego w repozytorium obrazów.
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
Update-AzureVMImage
[-ImageName] <String>
[-Label] <String>
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
[[-Language] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-DontShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Opis
Polecenie cmdlet Update-AzureVMImage aktualizuje etykietę na obrazie systemu operacyjnego w repozytorium obrazów. Zwraca obiekt obrazu z informacjami o zaktualizowanym obrazie.
Przykłady
Przykład 1. Aktualizowanie obrazu przez zmianę etykiety obrazu
PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"To polecenie aktualizuje obraz o nazwie Windows-Server-2008-SP2, zmieniając etykietę obrazu na DoNotUse.
Przykład 2: Pobieranie wszystkich systemów operacyjnych według etykiety, a następnie aktualizowanie etykiety
PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"To polecenie pobiera wszystkie obrazy systemu operacyjnego oznaczone etykietą DoNotUse i zmienia etykietę na Zaktualizowano.
Parametry
-Description
Określa opis obrazu systemu operacyjnego.
| Typ: | String |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskConfig
Określa konfigurację dysku systemu operacyjnego i dysku danych dla obrazu maszyny wirtualnej utworzonego przy użyciu poleceń cmdlet New-AzureVMImageDiskConfigSet, Set-AzureVMImageOSDiskConfig i Set-AzureVMImageDataDiskConfig .
| Typ: | VirtualMachineImageDiskConfigSet |
| Position: | 8 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DontShowInGui
Wskazuje, że to polecenie cmdlet nie wyświetla obrazu w graficznym interfejsie użytkownika.
| Typ: | SwitchParameter |
| Position: | 12 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Eula
Określa umowę licencyjną użytkownika końcowego. Zalecamy, aby wartość to adres URL.
| Typ: | String |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-IconName
Określa standardową nazwę ikony dla systemu operacyjnego lub obrazu maszyny wirtualnej.
| Typ: | String |
| Aliasy: | IconUri |
| Position: | 10 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ImageFamily
Określa wartość, która może służyć do grupowania obrazów systemu operacyjnego lub maszyny wirtualnej.
| Typ: | String |
| Position: | 4 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ImageName
Określa nazwę obrazu do zaktualizowania w repozytorium obrazów.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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 |
| Aliasy: | infa |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-InformationVariable
Określa zmienną informacyjną.
| Typ: | String |
| Aliasy: | iv |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Label
Określa nową etykietę obrazu.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Language
Określa język systemu operacyjnego na obrazie maszyny wirtualnej lub systemu operacyjnego.
| Typ: | String |
| Position: | 9 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PrivacyUri
Określa identyfikator URI wskazujący dokument zawierający zasady ochrony prywatności związane z obrazem systemu operacyjnego.
| Typ: | Uri |
| Position: | 6 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PublishedDate
Określa datę dodania obrazu systemu operacyjnego do repozytorium obrazów.
| Typ: | DateTime |
| Position: | 5 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-RecommendedVMSize
Określa rozmiar maszyny wirtualnej.
Dopuszczalne wartości tego parametru to:
- Śred.
- Duży
- EkstraLarge
- A5
- A6
- A7
| Typ: | String |
| Position: | 7 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-SmallIconName
Określa małą nazwę ikony dla systemu operacyjnego lub obrazu maszyny wirtualnej.
| Typ: | String |
| Aliasy: | SmallIconUri |
| Position: | 11 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
OSImageContext