New-AzResourceGroup

  • Referencia
Modul:
Az.Resources

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

Syntax

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

Description

A New-AzResourceGroup 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-AzResource 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-AzResourceGroupDeployment parancsmagot. Ha erőforrást szeretne hozzáadni egy meglévő erőforráscsoporthoz, használja a New-AzResource 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

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

Ez a parancs létrehoz egy erőforráscsoportot, amely nem rendelkezik erőforrásokkal. A New-AzResource vagy a New-AzResourceGroupDeployment 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

New-AzResourceGroup 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

New-AzResourceGroup -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.

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

-Confirm

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

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

-DefaultProfile

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

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzResourceProvider parancsmagot a ProviderNamespace paraméterrel.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzResource és a Get-AzResourceGroup 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-AzTag parancsmagot.

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

-WhatIf

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

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

Bevitelek

String

Hashtable

Kimenetek

PSResourceGroup