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

New-AzResourceGroup

  • 参考
模块:
Az.Resources

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

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