Поделиться через

New-AzResourceGroup

Модуль:
Az.Resources Module

Создает группы ресурсов Azure.

Синтаксис

Default (по умолчанию) 

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

Описание

Командлет New-AzResourceGroup создает группу ресурсов Azure. Вы можете создать группу ресурсов с помощью только имени и расположения, а затем использовать командлет New-AzResource для создания ресурсов для добавления в группу ресурсов. Чтобы добавить развертывание в существующую группу ресурсов, используйте командлет New-AzResourceGroupDeployment. Чтобы добавить ресурс в существующую группу ресурсов, используйте командлет New-AzResource. Ресурс Azure — это управляемая пользователем сущность Azure, например сервер базы данных, база данных или веб-сайт. Группа ресурсов Azure — это коллекция ресурсов Azure, развернутых как единица.

Примеры

Пример 1. Создание пустой группы ресурсов

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

Эта команда создает группу ресурсов, у которой нет ресурсов. Вы можете использовать командлеты New-AzResource или New-AzResourceGroupDeployment для добавления ресурсов и развертываний в эту группу ресурсов.

Пример 2. Создание пустой группы ресурсов с помощью позиционных параметров

New-AzResourceGroup RG01 "South Central US"

Эта команда создает группу ресурсов, у которой нет ресурсов.

Пример 3. Создание группы ресурсов с тегами

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

Эта команда создает пустую группу ресурсов. Эта команда аналогична команде в примере 1, за исключением того, что она назначает теги группе ресурсов. Первый тег с именем Empty можно использовать для идентификации групп ресурсов, у которых нет ресурсов. Второй тег называется Отделом и имеет значение Маркетинга. Вы можете использовать тег, например этот, для классификации групп ресурсов для администрирования или бюджетирования.

Параметры

-ApiVersion

Указывает версию API, поддерживаемую поставщиком ресурсов. Можно указать другую версию, отличную от версии по умолчанию.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Принудительно выполняется команда без запроса подтверждения пользователя.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Location

Указывает расположение группы ресурсов. Укажите расположение центра обработки данных Azure, например западная часть США или юго-восточная Азия. Группу ресурсов можно разместить в любом расположении. Группа ресурсов не должна находиться в том же расположении, что и подписка Azure или в том же расположении, что и ресурсы. Чтобы определить, какое расположение поддерживает каждый тип ресурса, используйте командлет Get-AzResourceProvider с параметром ProviderNamespace.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Указывает имя группы ресурсов. Имя ресурса должно быть уникальным в подписке. Если группа ресурсов с таким именем уже существует, командная строка запрашивает подтверждение перед заменой существующей группы ресурсов.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ИмяГруппыРесурсов

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Pre

Указывает, что этот командлет рассматривает версии API предварительной версии, когда она автоматически определяет, какую версию следует использовать.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"} Чтобы добавить или изменить тег, необходимо заменить коллекцию тегов для группы ресурсов. После назначения тегов ресурсам и группам можно использовать параметр тега тега Get-AzResource и Get-AzResourceGroup для поиска ресурсов и групп по имени и значению. Теги можно использовать для классификации ресурсов, таких как отдел или центр затрат, или для отслеживания заметок или комментариев о ресурсах. Чтобы получить стандартные теги, используйте командлет Get-AzTag.

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Метки

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Hashtable

Выходные данные

PSResourceGroup