Udostępnij za pośrednictwem


New-AzResourceGroup

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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 .

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String
Aliasy:ResourceGroupName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Pre

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Hashtable
Aliasy:Tags
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSResourceGroup