Megosztás a következőn keresztül:

New-AzureRmResourceGroup

  • Referencia
Modul:
AzureRM.Resources

Létrehoz egy Azure-erőforráscsoportot.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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

Description

A New-AzureRmResourceGroup parancsmag létrehoz egy Azure-erőforráscsoportot. Létrehozhat egy erőforráscsoportot csak egy név és hely használatával, majd a New-AzureRmResource parancsmaggal erőforrásokat hozhat létre az erőforráscsoporthoz való hozzáadáshoz. Ha üzembe helyezést szeretne hozzáadni egy meglévő erőforráscsoporthoz, használja a New-AzureRmResourceGroupDeployment parancsmagot. Ha erőforrást szeretne hozzáadni egy meglévő erőforráscsoporthoz, használja a New-AzureRmResource parancsmagot. Az Azure-erőforrások felhasználó által felügyelt Azure-entitások, például adatbázis-kiszolgáló, adatbázis vagy webhely. Az Azure-erőforráscsoport egy egységként üzembe helyezett Azure-erőforrások gyűjteménye.

Példák

1. példa: Üres erőforráscsoport létrehozása

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

Ez a parancs létrehoz egy erőforráscsoportot, amely nem rendelkezik erőforrásokkal. A New-AzureRmResource vagy a New-AzureRmResourceGroupDeployment parancsmagokkal erőforrásokat és üzembe helyezéseket adhat hozzá ehhez az erőforráscsoporthoz.

2. példa: Üres erőforráscsoport létrehozása pozícióparaméterekkel

PS> New-AzureRmResourceGroup RG01 "South Central US"

Ez a parancs létrehoz egy erőforráscsoportot, amely nem rendelkezik erőforrásokkal.

3. példa: Erőforráscsoport létrehozása címkékkel

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

Ez a parancs létrehoz egy üres erőforráscsoportot. Ez a parancs megegyezik az 1. példában szereplő paranccsal, azzal a kivételével, hogy címkéket rendel az erőforráscsoporthoz. Az első üres címke az erőforrásokkal nem rendelkező erőforráscsoportok azonosítására használható. A második címke neve Részleg, és marketing értékű. Egy ilyen címkével kategorizálhatja az erőforráscsoportokat felügyelet vagy költségvetés céljából.

Paraméterek

-ApiVersion

Az erőforrás-szolgáltató által támogatott API-verziót adja meg. Az alapértelmezett verziótól eltérő verziót is megadhat.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Típus:IAzureContextContainer
Aliasok:AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Location

Megadja az erőforráscsoport helyét. Adjon meg egy Azure-adatközpont helyét, például az USA nyugati régióját vagy Délkelet-Ázsiát. Az erőforráscsoportokat bármely helyen elhelyezheti. Az erőforráscsoportnak nem kell ugyanabban a helyen lennie az Azure-előfizetésében vagy az erőforrásaival azonos helyen. Annak megállapításához, hogy melyik hely támogatja az egyes erőforrástípusokat, használja a Get-AzureRmResourceProvider parancsmagot a ProviderNamespace paraméterrel.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja az erőforráscsoport nevét. Az erőforrás nevének egyedinek kell lennie az előfizetésben. Ha már létezik ilyen nevű erőforráscsoport, a parancssor megerősítést kér, mielőtt lecseréli a meglévő erőforráscsoportot.

Típus:String
Aliasok:ResourceGroupName
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Pre

Azt jelzi, hogy ez a parancsmag a kiadás előtti API-verziókat veszi figyelembe, amikor automatikusan meghatározza a használni kívánt verziót.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"} Címke hozzáadásához vagy módosításához le kell cserélnie az erőforráscsoport címkéinek gyűjteményét. Miután címkéket rendelt az erőforrásokhoz és csoportokhoz, a Get-AzureRmResource és a Get-AzureRmResourceGroup címkeparaméterével címkenév vagy név és érték alapján kereshet erőforrásokat és csoportokat. Címkék használatával kategorizálhatja az erőforrásokat, például részleg vagy költséghely szerint, vagy nyomon követheti az erőforrásokra vonatkozó megjegyzéseket vagy megjegyzéseket. Az előre definiált címkék lekéréséhez használja a Get-AzureRMTag parancsmagot.

Típus:Hashtable
Aliasok:Tags
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Kimenetek

Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup