New-AzResourceGroup

  • Odwołanie
Moduł:
Az.Resources

Tworzy grupę zasobów platformy Azure.

Składnia

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

Opis

Polecenie cmdlet New-AzResourceGroup tworzy grupę zasobów platformy Azure. Grupę zasobów można utworzyć przy użyciu tylko nazwy i lokalizacji, a następnie użyć polecenia cmdlet New-AzResource, aby utworzyć zasoby do dodania do grupy zasobów. Aby dodać wdrożenie do istniejącej grupy zasobów, użyj polecenia cmdlet New-AzResourceGroupDeployment. Aby dodać zasób do istniejącej grupy zasobów, użyj polecenia cmdlet New-AzResource . Zasób platformy Azure to zarządzana przez użytkownika jednostka platformy Azure, taka jak serwer bazy danych, baza danych lub witryna internetowa. Grupa zasobów platformy Azure to kolekcja zasobów platformy Azure, które są wdrażane jako jednostka.

Przykłady

Przykład 1. Tworzenie pustej grupy zasobów

New-AzResourceGroup -Name RG01 -Location "South Central US"

To polecenie tworzy grupę zasobów, która nie ma zasobów. Polecenia cmdlet New-AzResource lub New-AzResourceGroupDeployment umożliwiają dodawanie zasobów i wdrożeń do tej grupy zasobów.

Przykład 2. Tworzenie pustej grupy zasobów przy użyciu parametrów pozycyjnych

New-AzResourceGroup RG01 "South Central US"

To polecenie tworzy grupę zasobów, która nie ma zasobów.

Przykład 3. Tworzenie grupy zasobów z tagami

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

To polecenie tworzy pustą grupę zasobów. To polecenie jest takie samo jak polecenie w przykładzie 1, z tą różnicą, że przypisuje tagi do grupy zasobów. Pierwszy tag o nazwie Empty (Pusty) może służyć do identyfikowania grup zasobów, które nie mają zasobów. Drugi tag nosi nazwę Dział i ma wartość Marketing. Możesz użyć tagu takiego jak ten, aby kategoryzować grupy zasobów na potrzeby administracji lub budżetowania.

Parametry

-ApiVersion

Określa wersję interfejsu API obsługiwaną przez dostawcę zasobów. Możesz określić inną wersję niż domyślna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Określa lokalizację grupy zasobów. Określ lokalizację centrum danych platformy Azure, taką jak Zachodnie stany USA lub Azja Południowo-Wschodnia. Grupę zasobów można umieścić w dowolnej lokalizacji. Grupa zasobów nie musi znajdować się w tej samej lokalizacji subskrypcji platformy Azure lub w tej samej lokalizacji co jej zasoby. Aby określić, która lokalizacja obsługuje każdy typ zasobu, użyj polecenia cmdlet Get-AzResourceProvider z parametrem ProviderNamespace .

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwę grupy zasobów. Nazwa zasobu musi być unikatowa w subskrypcji. Jeśli grupa zasobów o tej nazwie już istnieje, polecenie wyświetli monit o potwierdzenie przed zastąpieniem istniejącej grupy zasobów.

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"} Aby dodać lub zmienić tag, musisz zastąpić kolekcję tagów dla grupy zasobów. Po przypisaniu tagów do zasobów i grup można użyć parametru Tag get-AzResource i Get-AzResourceGroup, aby wyszukać zasoby i grupy według nazwy tagu lub nazwy i wartości. Tagi umożliwiają kategoryzowanie zasobów, takich jak dział lub centrum kosztów, lub śledzenie notatek lub komentarzy dotyczących zasobów. Aby uzyskać wstępnie zdefiniowane tagi, użyj polecenia cmdlet Get-AzTag.

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSResourceGroup