Delen via


New-AzResourceGroup

Hiermee maakt u een Azure-resourcegroep.

Syntaxis

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

Description

Met de cmdlet New-AzResourceGroup maakt u een Azure-resourcegroep. U kunt een resourcegroep maken met alleen een naam en locatie en vervolgens de cmdlet New-AzResource gebruiken om resources te maken die u aan de resourcegroep wilt toevoegen. Als u een implementatie wilt toevoegen aan een bestaande resourcegroep, gebruikt u de cmdlet New-AzResourceGroupDeployment. Als u een resource wilt toevoegen aan een bestaande resourcegroep, gebruikt u de cmdlet New-AzResource . Een Azure-resource is een door de gebruiker beheerde Azure-entiteit, zoals een databaseserver, database of website. Een Azure-resourcegroep is een verzameling Azure-resources die als een eenheid worden geïmplementeerd.

Voorbeelden

Voorbeeld 1: Een lege resourcegroep maken

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

Met deze opdracht maakt u een resourcegroep zonder resources. U kunt de cmdlets New-AzResource of New-AzResourceGroupDeployment gebruiken om resources en implementaties toe te voegen aan deze resourcegroep.

Voorbeeld 2: Een lege resourcegroep maken met behulp van positionele parameters

New-AzResourceGroup RG01 "South Central US"

Met deze opdracht maakt u een resourcegroep zonder resources.

Voorbeeld 3: Een resourcegroep maken met tags

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

Met deze opdracht maakt u een lege resourcegroep. Deze opdracht is hetzelfde als de opdracht in voorbeeld 1, behalve dat deze tags toewijst aan de resourcegroep. De eerste tag, empty, kan worden gebruikt om resourcegroepen te identificeren die geen resources hebben. De tweede tag heet Afdeling en heeft de waarde Marketing. U kunt een tag zoals deze gebruiken om resourcegroepen te categoriseren voor beheer of budgettering.

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de resourcegroep. Geef een Azure-datacenterlocatie op, zoals VS - west of Azië - zuidoost. U kunt een resourcegroep op elke locatie plaatsen. De resourcegroep hoeft zich niet op dezelfde locatie te bevinden als uw Azure-abonnement of op dezelfde locatie als de bijbehorende resources. Gebruik de cmdlet Get-AzResourceProvider met de parameter ProviderNamespace om te bepalen welke locatie elk resourcetype ondersteunt.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een naam voor de resourcegroep. De resourcenaam moet uniek zijn in het abonnement. Als er al een resourcegroep met die naam bestaat, wordt u gevraagd om bevestiging voordat u de bestaande resourcegroep vervangt.

Type:String
Aliassen:ResourceGroupName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"} Als u een tag wilt toevoegen of wijzigen, moet u de verzameling tags voor de resourcegroep vervangen. Nadat u tags hebt toegewezen aan resources en groepen, kunt u de tagparameter van Get-AzResource en Get-AzResourceGroup gebruiken om te zoeken naar resources en groepen op tagnaam of op naam en waarde. U kunt tags gebruiken om uw resources te categoriseren, zoals per afdeling of kostenplaats, of om notities of opmerkingen over de resources bij te houden. Gebruik de Cmdlet Get-AzTag om uw vooraf gedefinieerde tags op te halen.

Type:Hashtable
Aliassen:Tags
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSResourceGroup