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

New-AzureRmResourceGroup

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

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

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

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

Примеры

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

PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"

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

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

PS> New-AzureRmResourceGroup RG01 "South Central US"

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

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

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

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

Параметры

-ApiVersion

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Тип:String
Aliases:ResourceGroupName
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

Тип:Hashtable
Aliases:Tags
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup