Get-AzureRmResourceGroupDeployment
取得資源群組中的部署。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 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>]
Description
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
指定要取得的資源群組部署標識碼。
類型: | 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