New-AzResourceGroup

Vytvoří skupinu prostředků Azure.

Syntax

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

Description

Rutina New-AzResourceGroup vytvoří skupinu prostředků Azure. Skupinu prostředků můžete vytvořit pouze pomocí názvu a umístění a pak pomocí rutiny New-AzResource vytvořit prostředky, které chcete přidat do skupiny prostředků. Pokud chcete přidat nasazení do existující skupiny prostředků, použijte rutinu New-AzResourceGroupDeployment. Pokud chcete přidat prostředek do existující skupiny prostředků, použijte rutinu New-AzResource . Prostředek Azure je entita Azure spravovaná uživatelem, jako je databázový server, databáze nebo web. Skupina prostředků Azure je kolekce prostředků Azure, které jsou nasazené jako jednotka.

Příklady

Příklad 1: Vytvoření prázdné skupiny prostředků

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

Tento příkaz vytvoří skupinu prostředků, která nemá žádné prostředky. K přidání prostředků a nasazení do této skupiny prostředků můžete použít rutiny New-AzResourceGroupDeployment.

Příklad 2: Vytvoření prázdné skupiny prostředků pomocí pozičních parametrů

New-AzResourceGroup RG01 "South Central US"

Tento příkaz vytvoří skupinu prostředků, která nemá žádné prostředky.

Příklad 3: Vytvoření skupiny prostředků se značkami

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

Tento příkaz vytvoří prázdnou skupinu prostředků. Tento příkaz je stejný jako příkaz v příkladu 1 s tím rozdílem, že přiřadí značky ke skupině prostředků. První značku s názvem Prázdné lze použít k identifikaci skupin prostředků, které nemají žádné prostředky. Druhá značka má název Oddělení a má hodnotu Marketing. K kategorizaci skupin prostředků pro správu nebo rozpočtování můžete použít značku, například tuto značku.

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

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

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

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

-Location

Určuje umístění skupiny prostředků. Zadejte umístění datového centra Azure, například USA – západ nebo Jihovýchodní Asie. Skupinu prostředků můžete umístit do libovolného umístění. Skupina prostředků nemusí být ve stejném umístění jako vaše předplatné Azure nebo ve stejném umístění jako její prostředky. Pokud chcete zjistit, které umístění podporuje jednotlivé typy prostředků, použijte rutinu Get-AzResourceProvider s parametrem ProviderNamespace .

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

-Name

Určuje název skupiny prostředků. Název prostředku musí být v předplatném jedinečný. Pokud skupina prostředků s tímto názvem již existuje, před nahrazením existující skupiny prostředků vás příkaz vyzve k potvrzení.

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

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

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

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"} Pokud chcete přidat nebo změnit značku, musíte nahradit kolekci značek pro skupinu prostředků. Po přiřazení značek k prostředkům a skupinám můžete použít parametr Tag get-AzResource a Get-AzResourceGroup k vyhledání prostředků a skupin podle názvu značky nebo podle názvu a hodnoty. Značky můžete použít ke kategorizaci prostředků, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům. K získání předdefinovaných značek použijte rutinu Get-AzTag.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

Hashtable

Výstupy

PSResourceGroup