Udostępnij za pośrednictwem

Set-AzureRmResourceGroup

  • Odwołanie
Moduł:
AzureRM.Resources

Modyfikuje grupę zasobów.

Ostrzeżenie

Moduł AzureRM PowerShell został 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

Set-AzureRmResourceGroup
   [-Name] <String>
   [-Tag] <Hashtable>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmResourceGroup
   [-Tag] <Hashtable>
   [-Id] <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureRmResourceGroup modyfikuje właściwości grupy zasobów. To polecenie cmdlet służy do dodawania, zmieniania lub usuwania tagów platformy Azure zastosowanych do grupy zasobów. Określ parametr Nazwa, aby zidentyfikować grupę zasobów i parametr Tag w celu zmodyfikowania tagów. Nie można użyć tego polecenia cmdlet, aby zmienić nazwę grupy zasobów.

Przykłady

Przykład 1. Stosowanie tagu do grupy zasobów

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

To polecenie stosuje tag Dział z wartością IT do grupy zasobów, która nie ma istniejących tagów.

Przykład 2. Dodawanie tagów do grupy zasobów

PS C:\>$Tags = (Get-AzureRmResourceGroup -Name "ContosoRG").Tags
PS C:\> $Tags
PS C:\> $Tags += @{"Status"="Approved"; "FY2016"=$null}
PS C:\> Set-AzureRmResourceGroup -Name "ContosoRG" -Tag $Tags
PS C:> (Get-AzureRmResourceGroup -Name "ContosoRG").Tags

W tym przykładzie do grupy zasobów z istniejącymi tagami dodano tag Status z wartością Approved i FY2016. Ponieważ tagi określone zastąp istniejące tagi, należy uwzględnić istniejące tagi w nowej kolekcji tagów lub utracisz je. Pierwsze polecenie pobiera grupę zasobów ContosoRG i używa metody kropki, aby uzyskać wartość jej właściwości Tags. Polecenie przechowuje tagi w zmiennej $Tags. Drugie polecenie pobiera tagi w zmiennej $Tags. Trzecie polecenie używa operatora += przypisania, aby dodać tagi Status i FY2016 do tablicy tagów w zmiennej $Tags. Czwarte polecenie używa parametru Tag polecenia Set-AzureRmResourceGroup, aby zastosować tagi w zmiennej $Tags do grupy zasobów ContosoRG. Piąte polecenie pobiera wszystkie tagi zastosowane do grupy zasobów ContosoRG. Dane wyjściowe pokazują, że grupa zasobów ma tag Dział i dwa nowe tagi: Status i FY2015.

Przykład 3. Usuwanie wszystkich tagów dla grupy zasobów

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{}

To polecenie określa parametr Tag z pustą wartością tabeli skrótów, aby usunąć wszystkie tagi z grupy zasobów ContosoRG.

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

-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

-Id

Określa identyfikator grupy zasobów do zmodyfikowania.

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

-Name

Określa nazwę grupy zasobów do zmodyfikowania.

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"} Tag to para nazwa-wartość, którą można utworzyć i zastosować do zasobów i grup 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 dodać lub zmienić tag, musisz zastąpić kolekcję tagów dla grupy zasobów. Aby usunąć tag, wprowadź tabelę skrótów z wszystkimi tagami aktualnie zastosowanymi do grupy zasobów z polecenia Get-AzureRmResourceGroup, z wyjątkiem tagu, który chcesz usunąć. Aby usunąć wszystkie tagi z grupy zasobów, określ pustą tabelę skrótów: @{}.

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

Dane wejściowe

None

Dane wyjściowe

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup