Aracılığıyla paylaş

Set-AzResourceGroup

  • Başvuru
Modül:
Az.Resources

Kaynak grubunu değiştirir.

Sözdizimi

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

Description

Set-AzResourceGroup cmdlet'i bir kaynak grubunun özelliklerini değiştirir. Bir kaynak grubuna uygulanan Azure etiketlerini eklemek, değiştirmek veya silmek için bu cmdlet'i kullanabilirsiniz. Kaynak grubunu tanımlamak için Name parametresini ve etiketleri değiştirmek için Tag parametresini belirtin. Kaynak grubunun adını değiştirmek için bu cmdlet'i kullanamazsınız.

Örnekler

Örnek 1: Kaynak grubuna etiket uygulama

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

Bu komut, mevcut etiketleri olmayan bir kaynak grubuna BT değerine sahip bir Department etiketi uygular.

Örnek 2: Kaynak grubuna etiket ekleme

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

Bu örnek, mevcut etiketleri olan bir kaynak grubuna Onaylı ve FY2016 etiketi içeren bir Durum etiketi ekler. Belirttiğiniz etiketler mevcut etiketleri değiştirdiğinden, mevcut etiketleri yeni etiket koleksiyonuna eklemeniz gerekir, aksi takdirde bunları kaybedersiniz. İlk komut ContosoRG kaynak grubunu alır ve Tags özelliğinin değerini almak için dot yöntemini kullanır. komutu etiketleri $Tags değişkeninde depolar. İkinci komut, $Tags değişkenindeki etiketleri alır. Üçüncü komut, Status ve FY2016 etiketlerini $Tags değişkenindeki etiket dizisine eklemek için += atama işlecini kullanır. Dördüncü komut, $Tags değişkenindeki etiketleri ContosoRG kaynak grubuna uygulamak için Set-AzResourceGroup'un Tag parametresini kullanır. Beşinci komut, ContosoRG kaynak grubuna uygulanan tüm etiketleri alır. Çıkış, kaynak grubunun Department etiketine ve iki yeni etikete (Status ve FY2015) sahip olduğunu gösterir.

Örnek 3: Kaynak grubunun tüm etiketlerini silme

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

Bu komut, ContosoRG kaynak grubundan tüm etiketleri silmek için boş bir karma tablo değeriyle Tag parametresini belirtir.

Parametreler

-ApiVersion

Kaynak Sağlayıcısı tarafından desteklenen API sürümünü belirtir. Varsayılan sürümden farklı bir sürüm belirtebilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Id

Değiştirileceği kaynak grubunun kimliğini belirtir.

Tür:String
Diğer adlar:ResourceGroupId, ResourceId
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Değiştirileceği kaynak grubunun adını belirtir.

Tür:String
Diğer adlar:ResourceGroupName
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Pre

Bu cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlediğinde yayın öncesi API sürümlerini göz önünde bulundurduğunu gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Tag

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"} Etiket, oluşturabileceğiniz ve kaynaklara ve kaynak gruplarına uygulayabileceğiniz bir ad-değer çiftidir. Kaynaklara ve gruplara etiket atadıktan sonra, kaynakları ve grupları etiket adına veya adına ve değerine göre aramak için Get-AzResource ve Get-AzResourceGroup Etiket parametresini kullanabilirsiniz. Departman veya maliyet merkezi gibi kaynaklarınızı kategorilere ayırmak veya kaynaklar hakkındaki notları veya açıklamaları izlemek için etiketleri kullanabilirsiniz. Etiket eklemek veya değiştirmek için kaynak grubunun etiket koleksiyonunu değiştirmeniz gerekir. Etiketi silmek için, silmek istediğiniz etiket dışında Get-AzResourceGroup'tan kaynak grubuna uygulanmış olan tüm etiketlerin bulunduğu bir karma tablo girin. Bir kaynak grubundan tüm etiketleri silmek için boş bir karma tablo belirtin: @{}.

Tür:Hashtable
Diğer adlar:Tags
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

String

Hashtable

Çıkışlar

PSResourceGroup