Udostępnij za pośrednictwem

Update-AzureVMImage

  • Odwołanie
Moduł:
Azure

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
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-DontShowInGui

Wskazuje, że to polecenie cmdlet nie wyświetla obrazu w graficznym interfejsie użytkownika.

Typ:SwitchParameter
Position:12
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-Eula

Określa umowę licencyjną użytkownika końcowego. Zalecamy, aby wartość to adres URL.

Typ:String
Position:2
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-IconName

Określa standardową nazwę ikony dla systemu operacyjnego lub obrazu maszyny wirtualnej.

Typ:String
Aliases:IconUri
Position:10
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageName

Określa nazwę obrazu do zaktualizowania w repozytorium obrazów.

Typ:String
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
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

-Label

Określa nową etykietę obrazu.

Typ:String
Position:1
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Language

Określa język systemu operacyjnego na obrazie maszyny wirtualnej lub systemu operacyjnego.

Typ:String
Position:9
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters: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
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

-PublishedDate

Określa datę dodania obrazu systemu operacyjnego do repozytorium obrazów.

Typ:DateTime
Position:5
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-RecommendedVMSize

Określa rozmiar maszyny wirtualnej.

Dopuszczalne wartości tego parametru to:

  • Śred.
  • Duży
  • EkstraLarge
  • A5
  • A6
  • A7
Typ:String
Position:7
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-SmallIconName

Określa małą nazwę ikony dla systemu operacyjnego lub obrazu maszyny wirtualnej.

Typ:String
Aliases:SmallIconUri
Position:11
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wyjściowe

OSImageContext