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

New-AzResourceGroup

  • Ссылка
Модуль:
Az.Resources

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

Синтаксис

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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Location

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

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String
Aliases:ResourceGroupName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Pre

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Tag

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

Тип:Hashtable
Aliases:Tags
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

Hashtable

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

PSResourceGroup