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 |