New-AzureRmResourceGroup
建立 Azure 資源群組。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzureRmResourceGroup Cmdlet 會建立 Azure 資源群組。 您可以只使用名稱和位置來建立資源群組，然後使用 New-AzureRmResource Cmdlet 來建立要新增至資源群組的資源。 若要將部署新增至現有的資源群組，請使用 New-AzureRmResourceGroupDeployment Cmdlet。 若要將資源新增至現有的資源群組，請使用 New-AzureRmResource Cmdlet。 Azure 資源是使用者管理的 Azure 實體，例如資料庫伺服器、資料庫或網站。 Azure 資源群組是部署為單位的 Azure 資源集合。
範例
範例 1：建立空的資源群組
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"此命令會建立沒有資源的資源群組。 您可以使用 New-AzureRmResource 或 New-AzureRmResourceGroupDeployment Cmdlet，將資源和部署新增至此資源群組。
範例 2：使用位置參數建立空白資源群組
PS> New-AzureRmResourceGroup RG01 "South Central US"此命令會建立沒有資源的資源群組。
範例 3：使用標籤建立資源群組
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}此命令會建立空的資源群組。 此命令與範例 1 中的命令相同，不同之處在於它會將標籤指派給資源群組。 名為 Empty 的第一個標籤可用來識別沒有資源的資源群組。 第二個標籤名為 Department，且值為 Marketing。 您可以使用這類標記來分類資源群組以進行管理或預算。
參數
-ApiVersion
指定資源提供者支援的 API 版本。 您可以指定與預設版本不同的版本。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Force
強制命令執行，而不要求使用者確認。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Location
指定資源群組的位置。 指定 Azure 資料中心位置，例如美國西部或東南亞。 您可以將資源群組放在任何位置。 資源群組不一定位於 Azure 訂用帳戶所在的相同位置，或位於與其資源相同的位置。 若要判斷哪個位置支援每個資源類型，請使用 Get-AzureRmResourceProvider Cmdlet 搭配 ProviderNamespace 參數。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定資源群組的名稱。 資源名稱在訂用帳戶中必須是唯一的。 如果已有該名稱的資源群組存在，命令會在取代現有的資源群組之前提示您確認。
| 類型: | String |
| 別名: | ResourceGroupName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Pre
指出此 Cmdlet 會在自動判斷要使用的版本時，考慮發行前版本 API 版本。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Tag
哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”} 若要新增或變更標記，您必須取代資源群組的標記集合。 將標籤指派給資源和群組之後，您可以使用 Get-AzureRmResource 和 Get-AzureRmResourceGroup 的 Tag 參數，依標記名稱或名稱和值搜尋資源和群組。 您可以使用標籤來分類您的資源，例如依部門或成本中心，或追蹤有關資源的附註或批註。 若要取得預先定義的標籤，請使用 Get-AzureRMTag Cmdlet。
| 類型: | Hashtable |
| 別名: | Tags |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup