Aracılığıyla paylaş

New-AzResourceGroup

  • Başvuru
Modül:
Az.Resources

Bir Azure kaynak grubu oluşturur.

Sözdizimi

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzResourceGroup cmdlet'i bir Azure kaynak grubu oluşturur. Yalnızca bir ad ve konum kullanarak bir kaynak grubu oluşturabilir ve ardından New-AzResource cmdlet'ini kullanarak kaynak grubuna eklenecek kaynaklar oluşturabilirsiniz. Mevcut bir kaynak grubuna dağıtım eklemek için New-AzResourceGroupDeployment cmdlet'ini kullanın. Var olan bir kaynak grubuna kaynak eklemek için New-AzResource cmdlet'ini kullanın. Azure kaynağı veritabanı sunucusu, veritabanı veya web sitesi gibi kullanıcı tarafından yönetilen bir Azure varlığıdır. Azure kaynak grubu, birim olarak dağıtılan Bir Azure kaynakları koleksiyonudur.

Örnekler

Örnek 1: Boş kaynak grubu oluşturma

New-AzResourceGroup -Name RG01 -Location "South Central US"

Bu komut, kaynakları olmayan bir kaynak grubu oluşturur. Bu kaynak grubuna kaynak ve dağıtım eklemek için New-AzResource veya New-AzResourceGroupDeployment cmdlet'lerini kullanabilirsiniz.

Örnek 2: Konumsal parametreleri kullanarak boş bir kaynak grubu oluşturma

New-AzResourceGroup RG01 "South Central US"

Bu komut, kaynakları olmayan bir kaynak grubu oluşturur.

Örnek 3: Etiketlerle kaynak grubu oluşturma

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

Bu komut boş bir kaynak grubu oluşturur. Bu komut, kaynak grubuna etiketler ataması dışında Örnek 1'deki komutla aynıdır. Boş adlı ilk etiket, kaynağı olmayan kaynak gruplarını tanımlamak için kullanılabilir. İkinci etiket Department olarak adlandırılır ve Pazarlama değerine sahiptir. Kaynak gruplarını yönetim veya bütçeleme için kategorilere ayırmak için bunun gibi bir etiket kullanabilirsiniz.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
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

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

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

-Location

Kaynak grubunun konumunu belirtir. Batı ABD veya Güneydoğu Asya gibi bir Azure veri merkezi konumu belirtin. Kaynak grubunu herhangi bir konuma yerleştirebilirsiniz. Kaynak grubunun Azure aboneliğinizle aynı konumda veya kaynaklarıyla aynı konumda olması gerekmez. Her kaynak türünü hangi konumun desteklediğini belirlemek için ProviderNamespace parametresiyle Get-AzResourceProvider cmdlet'ini kullanın.

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

-Name

Kaynak grubu için bir ad belirtir. Kaynak adı abonelikte benzersiz olmalıdır. Bu ada sahip bir kaynak grubu zaten varsa, komut mevcut kaynak grubunu değiştirmeden önce sizden onay ister.

Tür:String
Diğer adlar:ResourceGroupName
Position:0
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 eklemek veya değiştirmek için kaynak grubunun etiket koleksiyonunu değiştirmeniz gerekir. Kaynaklara ve gruplara etiket atadıktan sonra, kaynakları ve grupları etiket adına veya ada ve değere 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. Önceden tanımlanmış etiketlerinizi almak için Get-AzTag cmdlet'ini kullanın.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

String

Hashtable

Çıkışlar

PSResourceGroup