Get-AzureVMImage

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

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

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

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False