你当前正在访问 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 资源组中的部署。 指定 Name 或 Id 参数以筛选结果。 默认情况下, 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 以显示其 ResourceGroupName、 DeploymentName 和 ProvisioningState 属性值。
参数
-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