你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
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>] 说明
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