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 |