Udostępnij za pośrednictwem

Get-AzureVMImage

  • Odwołanie
Moduł:
Azure

Pobiera właściwości na jednej lub na liście systemów operacyjnych lub obrazu maszyny wirtualnej 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

Get-AzureVMImage
   [[-ImageName] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzureVMImage pobiera właściwości na jednej lub na liście systemów operacyjnych lub obrazu maszyny wirtualnej w repozytorium obrazów. Polecenie cmdlet zwraca informacje o wszystkich obrazach w repozytorium lub o określonym obrazie, jeśli podano jego nazwę obrazu.

Przykłady

Przykład 1. Pobieranie określonego obiektu obrazu z bieżącego repozytorium obrazów.

PS C:\> Get-AzureVMImage -ImageName Image001

To polecenie pobiera obiekt obrazu o nazwie Image001 z bieżącego repozytorium obrazów.

Przykład 2. Pobieranie wszystkich obrazów z bieżącego repozytorium obrazów

PS C:\> Get-AzureVMImage

To polecenie pobiera wszystkie obrazy z bieżącego repozytorium obrazów.

Przykład 3. Ustawianie kontekstu subskrypcji, a następnie pobieranie wszystkich obrazów

PS C:\> $SubsId = <MySubscriptionID>
C:\PS>$Cert = Get-AzureCertificate cert:\LocalMachine\MY\<CertificateThumbprint>
C:\PS>$MyOSImages = Get-AzureVMImage

To polecenie ustawia kontekst subskrypcji, a następnie pobiera wszystkie obrazy z repozytorium obrazów.

Parametry

-ImageName

Określa nazwę systemu operacyjnego lub obrazu maszyny wirtualnej w repozytorium obrazów. Jeśli nie określisz tego parametru, zostaną zwrócone wszystkie obrazy.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
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

-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