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
wartość domyślna:None
Wymagane:False
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

-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