Set-AzResourceGroup
Kaynak grubunu değiştirir.
Syntax
SetByResourceGroupName (Varsayılan)
Set-AzResourceGroup
[-Tag] <Hashtable>
-Name <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceGroupId
Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzResourceGroup cmdlet'i bir kaynak grubunun özelliklerini değiştirir. 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'unTag 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik
Parametre özellikleri
| Tür: | IAzureContextContainer |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | AzContext, AzureRmContext, AzureCredential |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Id
Değiştirileceği kaynak grubunun kimliğini belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | KaynakGrubuKimliği, ResourceId |
Parametre kümeleri
SetByResourceGroupId
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Değiştirileceği kaynak grubunun adını belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | ResourceGroupName |
Parametre kümeleri
SetByResourceGroupName
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, Get-AzResource ve Get-AzResourceGroup Etiket parametresini kullanarak kaynakları ve grupları etiket adına veya adına ve değerine göre arayabilirsiniz. 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: @{}.
Parametre özellikleri
| Tür: | Hashtable |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Etiketler |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.