Get-AzureVMImage

イメージ リポジトリ内のオペレーティング システムまたは仮想マシン イメージの 1 つまたは一覧のプロパティを取得します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

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

説明

Get-AzureVMImage コマンドレットは イメージ リポジトリ内のオペレーティング システムまたは仮想マシン イメージの 1 つまたは一覧のプロパティを取得します。 このコマンドレットは、リポジトリ内のすべてのイメージの情報、またはイメージ名が指定されている場合は特定のイメージに関する情報を返します。

例 1: 現在のイメージ リポジトリから特定のイメージ オブジェクトを取得します。

PS C:\> Get-AzureVMImage -ImageName Image001

このコマンドは、現在のイメージ リポジトリから Image001 という名前のイメージ オブジェクトを取得します。

例 2: 現在のイメージ リポジトリからすべてのイメージを取得する

PS C:\> Get-AzureVMImage

このコマンドは、現在のイメージ リポジトリからすべてのイメージを取得します。

例 3: サブスクリプション コンテキストを設定し、すべてのイメージを取得する

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

このコマンドは、サブスクリプション コンテキストを設定し、イメージ リポジトリからすべてのイメージを取得します。

パラメーター

-ImageName

イメージ リポジトリ内のオペレーティング システムまたは仮想マシン イメージの名前を指定します。 このパラメーターを指定しない場合は、すべてのイメージが返されます。

型:String
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

型:String
Aliases:iv
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False