New-AzureRmResourceGroup
Vytvoří skupinu prostředků Azure.
Upozorňující
Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Rutina New-AzureRmResourceGroup vytvoří skupinu prostředků Azure. Skupinu prostředků můžete vytvořit jenom pomocí názvu a umístění a pak pomocí rutiny New-AzureRmResource 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-AzureRmResourceGroupDeployment. Pokud chcete přidat prostředek do existující skupiny prostředků, použijte rutinu New-AzureRmResource . 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ů
PS> New-AzureRmResourceGroup -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-AzureRmResourceGroupDeployment.
Příklad 2: Vytvoření prázdné skupiny prostředků pomocí pozičních parametrů
PS> New-AzureRmResourceGroup 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
PS> New-AzureRmResourceGroup -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.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 každý typ prostředku, použijte rutinu Get-AzureRmResourceProvider s parametrem ProviderNamespace .
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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í.
| Typ: | String |
| Aliasy: | ResourceGroupName |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Pre
Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 pomocí parametru Tag Get-AzureRmResource a Get-AzureRmResourceGroup vyhledat prostředky a skupiny 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-AzureRMTag.
| Typ: | Hashtable |
| Aliasy: | Tags |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Výstupy
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup