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
- 阻止
- [中断]
型: | 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 |