New-AzResourceGroup

建立 Azure 資源群組。

Syntax

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzResourceGroup Cmdlet 會建立 Azure 資源群組。 您可以只使用名稱和位置來建立資源群組,然後使用 New-AzResource Cmdlet 來建立要新增至資源群組的資源。 若要將部署新增至現有的資源群組,請使用 New-AzResourceGroupDeployment Cmdlet。 若要將資源新增至現有的資源群組,請使用 New-AzResource Cmdlet。 Azure 資源是使用者管理的 Azure 實體,例如資料庫伺服器、資料庫或網站。 Azure 資源群組是部署為單位的 Azure 資源集合。

範例

範例 1:建立空的資源群組

New-AzResourceGroup -Name RG01 -Location "South Central US"

此命令會建立沒有資源的資源群組。 您可以使用 New-AzResourceNew-AzResourceGroupDeployment Cmdlet,將資源和部署新增至此資源群組。

範例 2:使用位置參數建立空白資源群組

New-AzResourceGroup RG01 "South Central US"

此命令會建立沒有資源的資源群組。

範例 3:使用標籤建立資源群組

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

此命令會建立空的資源群組。 此命令與範例 1 中的命令相同,不同之處在於它會將標籤指派給資源群組。 名為 Empty 的第一個標籤可用來識別沒有資源的資源群組。 第二個標籤名為 Department,且值為 Marketing。 您可以使用這類標記來分類資源群組以進行管理或預算。

參數

-ApiVersion

指定資源提供者支援的 API 版本。 您可以指定與預設版本不同的版本。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

強制命令執行,而不要求使用者確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

指定資源群組的位置。 指定 Azure 資料中心位置,例如美國西部或東南亞。 您可以將資源群組放在任何位置。 資源群組不一定位於 Azure 訂用帳戶所在的相同位置,或位於與其資源相同的位置。 若要判斷哪個位置支援每個資源類型,請使用 Get-AzResourceProvider Cmdlet 搭配 ProviderNamespace 參數。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定資源群組的名稱。 資源名稱在訂用帳戶中必須是唯一的。 如果已有該名稱的資源群組存在,命令會在取代現有的資源群組之前提示您確認。

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
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

-Tag

哈希表形式的索引鍵/值組。 例如:@{key0=“value0”;key1=$null;key2=“value2”} 若要新增或變更標記,您必須取代資源群組的標記集合。 將標籤名稱給資源和群組之後,您可以使用 Get-AzResource 和 Get-AzResourceGroup 的 Tag 參數,依標記名稱或名稱和值搜尋資源和群組。 您可以使用標籤來分類您的資源,例如依部門或成本中心,或追蹤有關資源的附註或批註。 若要取得預先定義的標籤,請使用 Get-AzTag Cmdlet。

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

Hashtable

輸出

PSResourceGroup