Get-AzResourceGroupDeployment

取得資源群組中的部署。

Syntax

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

Description

Get-AzResourceGroupDeployment Cmdlet 會取得 Azure 資源群組中的部署。 指定要篩選結果的 NameId 參數。 根據預設, Get-AzResourceGroupDeployment 會取得指定資源群組的所有部署。 Azure 資源是使用者管理的 Azure 實體,例如資料庫伺服器、資料庫或網站。 Azure 資源群組是部署為單位的 Azure 資源集合。 部署是讓資源群組中的資源可供使用的作業。 如需 Azure 資源和 Azure 資源群組的詳細資訊,請參閱 New-AzResourceGroup Cmdlet。 您可以使用此 Cmdlet 進行追蹤。 若要進行偵錯,請使用此 Cmdlet 搭配 Get-AzLog Cmdlet。

範例

範例 1:取得資源群組的所有部署

Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

此命令會取得 ContosoLabsRG 資源群組的所有部署。 輸出會顯示使用資源庫範本之 WordPress 部落格的部署。

範例 2:依名稱取得部署

Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

此命令會取得 ContosoLabsRG 資源群組的 DeployWebsite01 部署。 您可以使用 New-AzResourceGroup 或 New-AzResourceGroupDeployment Cmdlet,將名稱指派給部署。 如果您未指派名稱,Cmdlet 會根據用來建立部署的範本提供預設名稱。

範例 3:取得所有資源群組的部署

Get-AzResourceGroup | Get-AzResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

此命令會使用 Get-AzResourceGroup Cmdlet 取得訂用帳戶中的所有資源群組。 命令會使用管線運算符,將資源群組傳遞至目前的 Cmdlet。 目前的 Cmdlet 會取得訂用帳戶中所有資源群組的所有部署,並將結果傳遞至 Format-Table Cmdlet 以顯示其 ResourceGroupName、DeploymentNameProvisioningState 屬性值。

參數

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, 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

輸入

String

輸出

PSResourceGroupDeployment