New-AzResourceGroup
语法
Default （默认值）
New-AzResourceGroup
[-Name] <String>
[-Location] <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
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-AzResource 或 New-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 版本。
可以指定与默认版本不同的版本。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
强制命令运行而不要求用户确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Location
指定资源组的位置。 指定 Azure 数据中心位置，例如“美国西部”或“东南亚”。 可以将资源组放置在任何位置。 资源组不必位于 Azure 订阅所在的同一位置或与其资源位于同一位置。
若要确定哪个位置支持每个资源类型，请使用 Get-AzResourceProvider cmdlet 和 ProviderNamespace 参数。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
指定资源组的名称。 资源名称在订阅中必须是唯一的。 如果具有该名称的资源组已存在，则命令提示符在替换现有资源组之前进行确认。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 资源组名称 |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Pre
指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Tag
以哈希表的形式进行键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”} 若要添加或更改标记，必须替换资源组的标记集合。
将标记分配给资源和组后，可以使用 Get-AzResource 和 Get-AzResourceGroup 的 Tag 参数按标记名称或名称和值搜索资源和组。 可以使用标记按部门或成本中心对资源进行分类，或者跟踪有关资源的笔记或注释。
若要获取预定义的标记，请使用 Get-AzTag cmdlet。
参数属性
| 类型: | Hashtable
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 标记 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。
命令脚本未运行。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输出
