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

Get-AzureRmResource

获取资源。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Get-AzureRmResource
   [[-Name] <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-TagName <String>]
   [-TagValue <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResource
   -ResourceId <String>
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResource
   [[-Name] <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   -Tag <Hashtable>
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzureRmResource cmdlet 获取 Azure 资源。

示例

示例 1:获取当前订阅中的所有资源

PS C:\> Get-AzureRmResource | ft

Name    ResourceGroupName  ResourceType                            Location
----    -----------------  ------------                            --------
testVM  testRG             Microsoft.Compute/virtualMachines       westus
disk    testRG             Microsoft.Compute/disks                 westus
nic     testRG             Microsoft.Network/networkInterfaces     westus
nsg     testRG             Microsoft.Network/networkSecurityGroups westus
ip      testRG             Microsoft.Network/publicIPAddresses     westus
vnet    testRG             Microsoft.Network/virtualNetworks       westus
testKV  otherRG            Microsoft.KeyVault/vaults               eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts       eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines       eastus

此命令获取当前订阅中的所有资源。

示例 2:获取资源组中的所有资源

PS C:\> Get-AzureRmResource -ResourceGroupName testRG | ft

Name   ResourceGroupName ResourceType                            Location
----   ----------------- ------------                            --------
testVM testRG            Microsoft.Compute/virtualMachines       westus
disk   testRG            Microsoft.Compute/disks                 westus
nic    testRG            Microsoft.Network/networkInterfaces     westus
nsg    testRG            Microsoft.Network/networkSecurityGroups westus
ip     testRG            Microsoft.Network/publicIPAddresses     westus
vnet   testRG            Microsoft.Network/virtualNetworks       westus

此命令获取资源组“testRG”中的所有资源。

示例 3:获取其资源组与提供的野生资源匹配的所有资源卡

PS C:\> Get-AzureRmResource -ResourceGroupName other* | ft

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令获取其资源组属于“other”的所有资源。

示例 4:获取具有给定名称的所有资源

PS C:\> Get-AzureRmResource -Name testVM | fl

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

此命令获取其资源名称为“testVM”的所有资源。

示例 5:获取名称与提供的 wild 匹配的所有资源卡

PS C:\> Get-AzureRmResource -Name test* | ft

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令获取其资源名称以“test”开头的所有资源。

示例 6:获取给定资源类型的所有资源

PS C:\> Get-AzureRmResource -ResourceType Microsoft.Compute/virtualMachines | ft

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令获取当前订阅中虚拟机的所有资源。

示例 7:按资源 ID 获取资源

PS C:\> Get-AzureRmResource -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

此命令使用提供的资源 ID 获取资源,该 ID 是资源组“testRG”中名为“testVM”的虚拟机。

参数

-ApiVersion

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExpandProperties

指定后,展开资源的属性。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

要检索的资源的名称。 此参数支持字符串开头和/或末尾的 wild卡s。

类型:String
别名:ResourceName
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ODataQuery

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Pre

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

停用的资源所属的资源组。 此参数支持字符串开头和/或末尾的 wild卡s。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceId

指定完全限定的资源 ID,如以下示例所示 /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

类型:String
别名:Id
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceType

要检索的资源的资源类型。 例如,Microsoft.Compute/virtualMachines

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

获取具有指定 Azure 标记的资源。 输入具有 Name 键或 Name 和 Value 键的哈希表。 不支持 Wild卡 字符。“tag”是可以应用于资源和资源组的名称/值对。 使用标记对资源进行分类,例如按部门或成本中心分类,或跟踪有关资源的笔记或注释。 若要将标记添加到资源,请使用 New-AzureRmResource 或 Set-AzureRmResource cmdlet 的 Tag 参数。 若要创建预定义标记,请使用 New-AzureRmTag cmdlet。 有关 Windows PowerShell 中哈希表的帮助,请运行“Get-Help about_Hashtables”。

类型:Hashtable
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TagName

要检索的资源标记中的键。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TagValue

要检索的资源标记中的值。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

Microsoft.Azure.Commands.ResourceManagement.Models.PSResource