Get-AzResourceGroup
語法
GetByResourceGroupName (預設值)
Get-AzResourceGroup
[[-Name] <String>]
[[-Location] <String>]
[-Tag <Hashtable>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetByResourceGroupId
Get-AzResourceGroup
[[-Location] <String>]
[-Id <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-AzResourceGroup Cmdlet 會取得目前訂用帳戶中的 Azure 資源群組。
您可以取得所有資源群組，或依名稱或其他內容指定資源群組。
根據預設，此 Cmdlet 會取得目前訂用帳戶中的所有資源群組。
如需 Azure 資源和 Azure 資源群組的詳細資訊，請參閱 New-AzResourceGroup Cmdlet。
範例
範例 1：依名稱取得資源群組
Get-AzResourceGroup -Name "EngineerBlog"
此命令會取得訂用帳戶中名為 EngineerBlog 的 Azure 資源群組。
範例 2：取得資源群組的所有標籤
(Get-AzResourceGroup -Name "ContosoRG").Tags
此命令會取得名為 ContosoRG 的資源群組，並顯示與該群組相關聯的標籤。
範例 3：根據標籤取得資源群組
Get-AzResourceGroup -Tag @{'environment'='prod'}
範例 4：依位置顯示資源群組
Get-AzResourceGroup |
Sort-Object Location,ResourceGroupName |
Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags
範例 5：顯示特定位置中所有資源群組的名稱
Get-AzResourceGroup -Location westus2 |
Sort-Object ResourceGroupName |
Format-Wide ResourceGroupName -Column 4
範例 6：顯示名稱以 WebServer 開頭的資源群組
Get-AzResourceGroup -Name WebServer*
範例 7：取得具有展開屬性的資源群組
Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties
參數
-ApiVersion
指定資源提供者支援的 API 版本。
您可以指定與預設版本不同的版本。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExpandProperties
指定時，輸出會包含資源的 CreatedTime 和 ChangedTime。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定要取得的資源群組識別碼。
不允許使用萬用字元。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 資源群組標識符, 資源識別碼 (ResourceId) |
參數集
GetByResourceGroupId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Location
指定要取得的資源群組位置。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定要取得的資源群組名稱。 此參數支援字串開頭和/或結尾的萬用字元。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | ResourceGroupName |
參數集
GetByResourceGroupName
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Pre
指出此 Cmdlet 在自動決定要使用的版本時，會考慮發行前 API 版本。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tag
要篩選資源群組的標籤雜湊表。
參數屬性
| 類型: | Hashtable
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetByResourceGroupName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
