New-AzureRmResourceGroup

  • Başvuru
Modül:
AzureRM.Resources

Bir Azure kaynak grubu oluşturur.

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

Sözdizimi

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

Description

New-AzureRmResourceGroup cmdlet'i bir Azure kaynak grubu oluşturur. Yalnızca bir ad ve konum kullanarak bir kaynak grubu oluşturabilir ve ardından New-AzureRmResource cmdlet'ini kullanarak kaynak grubuna eklenecek kaynaklar oluşturabilirsiniz. Mevcut bir kaynak grubuna dağıtım eklemek için New-AzureRmResourceGroupDeployment cmdlet'ini kullanın. Mevcut bir kaynak grubuna kaynak eklemek için New-AzureRmResource 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

PS> New-AzureRmResourceGroup -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-AzureRmResource veya New-AzureRmResourceGroupDeployment cmdlet'lerini kullanabilirsiniz.

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

PS> New-AzureRmResourceGroup RG01 "South Central US"

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

Örnek 3: Etiketlerle kaynak grubu oluşturma

PS> New-AzureRmResourceGroup -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: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. Hangi konumun her kaynak türünü desteklediğini belirlemek için ProviderNamespace parametresiyle Get-AzureRmResourceProvider cmdlet'ini kullanın.

Tür:String
Position:Named
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: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 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-AzureRmResource ve Get-AzureRmResourceGroup 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-AzureRMTag 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

None

Çıkışlar

Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup