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-AzResourceGroupDeployment или 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 можно использовать для идентификации групп ресурсов, у которых нет ресурсов. Второй тег называется Department и имеет значение Marketing. Вы можете использовать такой тег, чтобы классифицировать группы ресурсов для администрирования или бюджетирования.

Параметры

-ApiVersion

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Location

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

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

Hashtable

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

PSResourceGroup