共用方式為


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-AzureRmResourceNew-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