你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzureVMImage

获取映像存储库中一个或多个操作系统或虚拟机映像的列表的属性。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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

说明

Get-AzureVMImage cmdlet 获取映像存储库中操作系统或虚拟机映像列表上的属性。 该 cmdlet 返回存储库中所有映像的信息,或有关特定映像的信息(如果提供了其映像名称)。

示例

示例 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
Position:0
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
Aliases:infa
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定信息变量。

类型:String
Aliases:iv
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False