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

Get-AzureRmResourceGroupDeployment

获取资源组中的部署。

警告

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

尽管 AzureRM 模块仍可运行,但不再受到维护或支持,任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Get-AzureRmResourceGroupDeployment
   [-ResourceGroupName] <String>
   [[-Name] <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResourceGroupDeployment
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzureRmResourceGroupDeployment cmdlet 获取 Azure 资源组中的部署。 指定 NameId 参数以筛选结果。 默认情况下, Get-AzureRmResourceGroupDeployment 获取指定资源组的所有部署。 Azure 资源是用户管理的 Azure 实体,例如数据库服务器、数据库或网站。 Azure 资源组是部署为单元的 Azure 资源的集合。 部署是使资源组中的资源可供使用的操作。 有关 Azure 资源和 Azure 资源组的详细信息,请参阅 New-AzureRmResourceGroup cmdlet。 可以使用此 cmdlet 进行跟踪。 若要进行调试,请使用此 cmdlet 和 Get-AzureRmLog cmdlet。

示例

示例 1:获取资源组的所有部署

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

此命令获取 ContosoLabsRG 资源组的所有部署。 输出显示了使用库模板的 WordPress 博客的部署。

示例 2:按名称获取部署

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

此命令获取 ContosoLabsRG 资源组的 DeployWebsite01 部署。 可以使用 New-AzureRmResourceGroup 或 New-AzureRmResourceGroupDeployment cmdlet 为部署分配名称。 如果未分配名称,则 cmdlet 会根据用于创建部署的模板提供默认名称。

示例 3:获取所有资源组的部署

PS C:\>Get-AzureRmResourceGroup | Get-AzureRmResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

此命令使用 Get-AzureRmResourceGroup cmdlet 获取订阅中的所有资源组。 该命令使用管道运算符将资源组传递到当前 cmdlet。 当前 cmdlet 获取订阅中所有资源组的所有部署,并将结果传递给 Format-Table cmdlet 以显示其 ResourceGroupNameDeploymentNameProvisioningState 属性值。

参数

-ApiVersion

指定资源提供程序支持的 API 版本。 可以指定与默认版本不同的版本。

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

-DefaultProfile

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

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

-Id

指定要获取的资源组部署的 ID。

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

-Name

指定要获取的部署的名称。 不允许使用通配符。

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

-Pre

指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。

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

-ResourceGroupName

指定资源组的名称。 该 cmdlet 获取此参数指定的资源组的部署。 不允许使用通配符。 此参数是必需的,每个命令中只能指定一个资源组。

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

输入

None

输出

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment