你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzResourceGroup

创建 Azure 资源组。

语法

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-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 版本。 可以指定与默认版本不同的版本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

强制运行命令而不要求用户确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

指定资源组的位置。 指定 Azure 数据中心位置,例如“美国西部”或“东南亚”。 可以将资源组放置在任何位置。 资源组不必位于 Azure 订阅所在的同一位置或与其资源位于同一位置。 若要确定哪个位置支持每个资源类型,请使用 Get-AzResourceProvider cmdlet 和 ProviderNamespace 参数。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定资源组的名称。 资源名称在订阅中必须是唯一的。 如果具有该名称的资源组已存在,则命令提示符在替换现有资源组之前进行确认。

类型:String
别名:ResourceGroupName
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Pre

指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

以哈希表的形式进行键值对。 例如:@{key0=“value0”;key1=$null;key2=“value2”} 若要添加或更改标记,必须替换资源组的标记集合。 将标记分配给资源和组后,可以使用 Get-AzResource 和 Get-AzResourceGroup 的 Tag 参数按标记名称或名称和值搜索资源和组。 可以使用标记按部门或成本中心对资源进行分类,或者跟踪有关资源的笔记或注释。 若要获取预定义的标记,请使用 Get-AzTag cmdlet。

类型:Hashtable
别名:Tags
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

String

Hashtable

输出

PSResourceGroup