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.
Syntax
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 |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
standaardwaarde: | False |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
Type: | SwitchParameter |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
standaardwaarde: | None |
Vereist: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | ResourceGroupName |
Position: | Named |
standaardwaarde: | None |
Vereist: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | Tags |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
standaardwaarde: | False |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
Uitvoerwaarden
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup