New-AzureRmResourceGroup
Hiermee maakt u een Azure-resourcegroep.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntaxis
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de cmdlet New-AzureRmResourceGroup maakt u een Azure-resourcegroep. U kunt een resourcegroep maken met alleen een naam en locatie en vervolgens de cmdlet New-AzureRmResource 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-AzureRmResourceGroupDeployment. Als u een resource wilt toevoegen aan een bestaande resourcegroep, gebruikt u de cmdlet New-AzureRmResource . 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
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"
Met deze opdracht maakt u een resourcegroep zonder resources. U kunt de cmdlets New-AzureRmResource of New-AzureRmResourceGroupDeployment gebruiken om resources en implementaties toe te voegen aan deze resourcegroep.
Voorbeeld 2: Een lege resourcegroep maken met behulp van positionele parameters
PS> New-AzureRmResourceGroup RG01 "South Central US"
Met deze opdracht maakt u een resourcegroep zonder resources.
Voorbeeld 3: Een resourcegroep maken met tags
PS> New-AzureRmResourceGroup -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: | 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. Als u wilt bepalen welke locatie elk resourcetype ondersteunt, gebruikt u de cmdlet Get-AzureRmResourceProvider met de parameter ProviderNamespace .
Type: | String |
Position: | Named |
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: | Named |
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-AzureRmResource en Get-AzureRmResourceGroup 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-AzureRMTag 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
None
Uitvoerwaarden
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup