Delen via


New-AzResourceGroup

Hiermee maakt u een Azure-resourcegroep.

Syntaxis

Default (Standaard)

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 behulp van 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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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. Als u wilt bepalen welke locatie elk resourcetype ondersteunt, gebruikt u de cmdlet Get-AzResourceProvider met de parameter ProviderNamespace .

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ResourceGroupName

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Pre

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 Get-AzTag-cmdlet om uw vooraf gedefinieerde tags op te halen.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Tags

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSResourceGroup