New-AzureRmResourceGroup
Tworzy grupę zasobów platformy Azure.
Ostrzeżenie
Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.
Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.
Składnia
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Opis
Polecenie cmdlet New-AzureRmResourceGroup 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-AzureRmResource, aby utworzyć zasoby, aby dodać je do grupy zasobów. Aby dodać wdrożenie do istniejącej grupy zasobów, użyj polecenia cmdlet New-AzureRmResourceGroupDeployment. Aby dodać zasób do istniejącej grupy zasobów, użyj polecenia cmdlet New-AzureRmResource . 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
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"To polecenie tworzy grupę zasobów, która nie ma zasobów. Polecenia cmdlet New-AzureRmResource lub New-AzureRmResourceGroupDeployment 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
PS> New-AzureRmResourceGroup 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
PS> New-AzureRmResourceGroup -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: | 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-AzureRmResourceProvider z parametrem ProviderNamespace .
| Typ: | String |
| Position: | Named |
| 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: | Named |
| 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-AzureRmResource i Get-AzureRmResourceGroup, 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-AzureRMTag.
| 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
None
Dane wyjściowe
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup