Set-AzResourceGroup
Modyfikuje grupę zasobów.
Składnia
Set-AzResourceGroup
-Name <String>
[-Tag] <Hashtable>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-AzResourceGroup 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
Set-AzResourceGroup -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
$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -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-AzResourceGroup, 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
Set-AzResourceGroup -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.
Type: | String |
Position: | Named |
Default value: | None |
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 |
-Id
Określa identyfikator grupy zasobów do zmodyfikowania.
Type: | String |
Aliases: | ResourceGroupId, ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Określa nazwę grupy zasobów do zmodyfikowania.
Type: | String |
Aliases: | ResourceGroupName |
Position: | Named |
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"} 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-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 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-AzResourceGroup, z wyjątkiem tagu, który chcesz usunąć. Aby usunąć wszystkie tagi z grupy zasobów, określ pustą tabelę skrótów: @{}
.
Type: | Hashtable |
Aliases: | Tags |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
Dane wyjściowe
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla