Share via


Get-AzureRmResourceGroupDeployment

取得資源群組中的部署。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

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

Description

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 以顯示其 ResourceGroupName、DeploymentNameProvisioningState 屬性值。

參數

-ApiVersion

指定資源提供者支援的 API 版本。 您可以指定與預設版本不同的版本。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定要取得的資源群組部署標識碼。

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要取得的部署名稱。 不允許通配符。

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

指出此 Cmdlet 會在自動判斷要使用的版本時,考慮發行前版本 API 版本。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

指定資源群組的名稱。 Cmdlet 會取得此參數所指定資源群組的部署。 不允許通配符。 這是必要參數,而且每個命令中只能指定一個資源群組。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

輸入

None

輸出

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment