Dela via

New-AzResourceGroup

Modul:
Az.Resources Module

Skapar en Azure-resursgrupp.

Syntax

Default (Standard) 

New-AzResourceGroup
    [-Name] <String>
    [-Location] <String>
    [-Tag <Hashtable>]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten New-AzResourceGroup skapar en Azure-resursgrupp. Du kan skapa en resursgrupp med bara ett namn och en plats och sedan använda cmdleten New-AzResource 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-AzResourceGroupDeployment. Om du vill lägga till en resurs i en befintlig resursgrupp använder du cmdleten New-AzResource . 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

New-AzResourceGroup -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-AzResource eller New-AzResourceGroupDeployment 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

New-AzResourceGroup RG01 "South Central US"

Det här kommandot skapar en resursgrupp som inte har några resurser.

Exempel 3: Skapa en resursgrupp med taggar

New-AzResourceGroup -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

-ApiVersion

Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Location

Anger platsen för resursgruppen. Ange en Azure-datacenterplats, till exempel USA, västra eller Asien, sydöstra. 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-AzResourceProvider med parametern ProviderNamespace .

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Anger ett namn för resursgruppen. Resursnamnet måste vara unikt i prenumerationen. Om det redan finns en resursgrupp med det namnet uppmanas du att bekräfta innan du ersätter den befintliga resursgruppen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ResourceGroupName

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Pre

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

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-AzResource och Get-AzResourceGroup 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-AzTag.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Etiketter

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Hashtable

Utdata

PSResourceGroup