New-AzureRmResourceGroup
Skapar en Azure-resursgrupp.
Viktigt
Eftersom Az PowerShell-moduler nu har alla funktioner i AzureRM PowerShell-moduler och mycket mer drar vi tillbaka AzureRM PowerShell-moduler den 29 februari 2024.
För att undvika avbrott i tjänsten uppdaterar du skripten som använder AzureRM PowerShell-moduler för att använda Az PowerShell-moduler senast den 29 februari 2024. Följ snabbstartsguiden om du vill uppdatera skripten automatiskt.
Syntax
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cmdleten New-AzureRmResourceGroup skapar en Azure-resursgrupp . Du kan skapa en resursgrupp med bara ett namn och en plats och sedan använda cmdleten New-AzureRmResource för att skapa resurser som ska läggas till i resursgruppen. Om du vill lägga till en distribution till en befintlig resursgrupp använder du cmdleten New-AzureRmResourceGroupDeployment. Om du vill lägga till en resurs i en befintlig resursgrupp använder du cmdleten New-AzureRmResource . En Azure-resurs är en användarhanterad Azure-entitet, till exempel en databasserver, databas eller webbplats. En Azure-resursgrupp är en samling Azure-resurser som distribueras som en enhet.
Exempel
Exempel 1: Skapa en tom resursgrupp
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"Det här kommandot skapar en resursgrupp som inte har några resurser. Du kan använda cmdletarna New-AzureRmResource eller New-AzureRmResourceGroupDeployment för att lägga till resurser och distributioner i den här resursgruppen.
Exempel 2: Skapa en tom resursgrupp med hjälp av positionsparametrar
PS> New-AzureRmResourceGroup RG01 "South Central US"Det här kommandot skapar en resursgrupp som inte har några resurser.
Exempel 3: Skapa en resursgrupp med taggar
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}Det här kommandot skapar en tom resursgrupp. Det här kommandot är samma som kommandot i Exempel 1, förutom att det tilldelar taggar till resursgruppen. Den första taggen med namnet Tom kan användas för att identifiera resursgrupper som inte har några resurser. Den andra taggen heter Avdelning och har värdet Marknadsföring. Du kan använda en tagg som den här för att kategorisera resursgrupper för administration eller budgetering.
Parametrar
Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Uppmanar dig att bekräfta innan du kör cmdleten.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Tvingar kommandot att köras utan att be om användarbekräftelse.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Anger platsen för resursgruppen. Ange en Azure-datacenterplats, till exempel USA, västra eller Sydostasien. Du kan placera en resursgrupp på valfri plats. Resursgruppen behöver inte finnas på samma plats som din Azure-prenumeration eller på samma plats som dess resurser. Om du vill avgöra vilken plats som stöder varje resurstyp använder du cmdleten Get-AzureRmResourceProvider med parametern ProviderNamespace .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Anger ett namn för resursgruppen. Resursnamnet måste vara unikt i prenumerationen. Om det redan finns en resursgrupp med det namnet uppmanar kommandot dig att bekräfta innan du ersätter den befintliga resursgruppen.
| Type: | String |
| Aliases: | ResourceGroupName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0";key1=$null;key2="value2"} Om du vill lägga till eller ändra en tagg måste du ersätta samlingen med taggar för resursgruppen. När du har tilldelat taggar till resurser och grupper kan du använda taggparametern för Get-AzureRmResource och Get-AzureRmResourceGroup för att söka efter resurser och grupper efter taggnamn eller efter namn och värde. Du kan använda taggar för att kategorisera dina resurser, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurserna. Om du vill hämta dina fördefinierade taggar använder du cmdleten Get-AzureRMTag.
| Type: | Hashtable |
| Aliases: | Tags |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Indata
None
Utdata
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup