Aracılığıyla paylaş

New-AzResourceGroup

Modül:
Az.Resources Module

Bir Azure kaynak grubu oluşturur.

Syntax

Default (Varsayılan) 

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.

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

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

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

-Force

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

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

-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-AzResourceProvider cmdlet'ini kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

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

-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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:ResourceGroupName

Parametre kümeleri

(All)
Position:0
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 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.

Parametre özellikleri

Tür:Hashtable
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Etiketler

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:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

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

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.

Girişler

String

Hashtable

Çıkışlar

PSResourceGroup