Set-AzResourceGroup

  • Referensi
Modul:
Az.Resources

Memodifikasi grup sumber daya.

Sintaks

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

Deskripsi

Cmdlet Set-AzResourceGroup memodifikasi properti grup sumber daya. Anda dapat menggunakan cmdlet ini untuk menambahkan, mengubah, atau menghapus tag Azure yang diterapkan ke grup sumber daya. Tentukan parameter Nama untuk mengidentifikasi grup sumber daya dan parameter Tag untuk mengubah tag. Anda tidak dapat menggunakan cmdlet ini untuk mengubah nama grup sumber daya.

Contoh

Contoh 1: Menerapkan tag ke grup sumber daya

Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Perintah ini menerapkan tag Departemen dengan nilai IT ke grup sumber daya yang tidak memiliki tag yang ada.

Contoh 2: Menambahkan tag ke grup sumber daya

$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags

Contoh ini menambahkan tag Status dengan nilai Disetujui dan tag FY2016 ke grup sumber daya yang memiliki tag yang sudah ada. Karena tag yang Anda tentukan mengganti tag yang ada, Anda harus menyertakan tag yang ada dalam koleksi tag baru atau Anda akan kehilangan tag tersebut. Perintah pertama mendapatkan grup sumber daya ContosoRG dan menggunakan metode titik untuk mendapatkan nilai properti Tag-nya. Perintah menyimpan tag dalam variabel $Tags. Perintah kedua mendapatkan tag dalam variabel $Tags. Perintah ketiga menggunakan operator penugasan += untuk menambahkan tag Status dan FY2016 ke array tag dalam variabel $Tags. Perintah keempat menggunakan parameter Tag Set-AzResourceGroup untuk menerapkan tag dalam variabel $Tags ke grup sumber daya ContosoRG. Perintah kelima mendapatkan semua tag yang diterapkan ke grup sumber daya ContosoRG. Output menunjukkan bahwa grup sumber daya memiliki tag Departemen dan dua tag baru, Status dan FY2015.

Contoh 3: Menghapus semua tag untuk grup sumber daya

Set-AzResourceGroup -Name "ContosoRG" -Tag @{}

Perintah ini menentukan parameter Tag dengan nilai tabel hash kosong untuk menghapus semua tag dari grup sumber daya ContosoRG.

Parameter

-ApiVersion

Menentukan versi API yang didukung oleh Penyedia sumber daya. Anda dapat menentukan versi yang berbeda dari versi default.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

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

-Id

Menentukan ID grup sumber daya yang akan diubah.

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama grup sumber daya yang akan diubah.

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

-Pre

Menunjukkan bahwa cmdlet ini mempertimbangkan versi API pra-rilis ketika secara otomatis menentukan versi mana yang akan digunakan.

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

-Tag

Pasangan kunci-nilai dalam bentuk tabel hash. Misalnya: @{key0="value0"; key1=$null; key2="value2"} Tag adalah pasangan nama-nilai yang dapat Anda buat dan terapkan ke sumber daya dan grup sumber daya. Setelah menetapkan tag ke sumber daya dan grup, Anda dapat menggunakan parameter Tag Get-AzResource dan Get-AzResourceGroup untuk mencari sumber daya dan grup menurut nama atau nama dan nilai tag. Anda dapat menggunakan tag untuk mengategorikan sumber daya Anda, seperti berdasarkan departemen atau pusat biaya, atau untuk melacak catatan atau komentar tentang sumber daya. Untuk menambahkan atau mengubah tag, Anda harus mengganti kumpulan tag untuk grup sumber daya. Untuk menghapus tag, masukkan tabel hash dengan semua tag yang saat ini diterapkan ke grup sumber daya, dari Get-AzResourceGroup, kecuali tag yang ingin Anda hapus. Untuk menghapus semua tag dari grup sumber daya, tentukan tabel hash kosong: @{}.

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

Input

String

Hashtable

Output

PSResourceGroup