Aracılığıyla paylaş

New-AzResource

  • Başvuru
Modül:
Az.Resources

Bir kaynak oluşturur.

Sözdizimi

New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceId <String>
   [-ODataQuery <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-TenantLevel]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzResource cmdlet'i bir kaynak grubunda web sitesi, Azure SQL Veritabanı sunucusu veya Azure SQL Veritabanı gibi bir Azure kaynağı oluşturur.

Örnekler

Örnek 1: Kaynak oluşturma

New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force

Bu komut ResourceGroup11'de bir web sitesi olan bir kaynak oluşturur.

Örnek 2: Splatting kullanarak kaynak oluşturma

$prop = @{
    Location          = "West US"
    Properties        = @{test = "test"}
    ResourceName      = "TestSite06"
    ResourceType      = "microsoft.web/sites"
    ResourceGroupName = "ResourceGroup11"
    Force             = $true
}

New-AzResource @prop

Bu komut ResourceGroup11'de bir web sitesi olan bir kaynak oluşturur.

Parametreler

-ApiVersion

Kullanılacak kaynak sağlayıcısı API'sinin sürümünü belirtir. Bir sürüm belirtmezseniz, bu cmdlet kullanılabilir en son sürümü kullanır.

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

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:SwitchParameter
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

-ExtensionResourceName

Kaynak için uzantı kaynağının adını belirtir. Örneğin, bir veritabanı belirtmek için şu biçimi kullanın: sunucu adı/veritabanı adı

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

-ExtensionResourceType

Uzantı kaynağının kaynak türünü belirtir. Örneğin, uzantı kaynağı bir veritabanıysa aşağıdaki türü belirtin: Microsoft.Sql/Servers/Databases

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
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

-IsFullObject

Properties parametresinin belirttiği nesnenin tam nesne olduğ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

-Kind

Kaynağın kaynak türünü belirtir.

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

-Location

Kaynağın konumunu belirtir. Orta ABD veya Güneydoğu Asya gibi veri merkezi konumunu belirtin. Bir kaynağı, bu türdeki kaynakları destekleyen herhangi bir konuma yerleştirebilirsiniz. Kaynak grupları farklı konumlardan kaynaklar içerebilir. Hangi konumların her kaynak türünü desteklediğini belirlemek için Get-AzLocation cmdlet'ini kullanın.

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

-ODataQuery

Açık Veri Protokolü (OData) stil filtresini belirtir. Bu cmdlet, diğer filtrelere ek olarak bu değeri isteğe ekler.

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

-Plan

Kaynak planı özelliklerini temsil eden karma tablo.

Tür:Hashtable
Diğer adlar:PlanObject
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
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

-Properties

Kaynağın kaynak özelliklerini belirtir. Bir kaynak türüne özgü özelliklerin değerlerini belirtmek için bu parametreyi kullanın.

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

-ResourceGroupName

Bu cmdlet'in kaynağı oluşturduğu kaynak grubunun adını belirtir.

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

-ResourceId

Aşağıdaki örnekte olduğu gibi abonelik de dahil olmak üzere tam kaynak kimliğini belirtir: /subscriptions/abonelik kimliği/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

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

-ResourceName

Kaynağın adını belirtir. Örneğin, bir veritabanı belirtmek için aşağıdaki biçimi kullanın: ContosoServer/ContosoDatabase

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

-ResourceType

Kaynağın türünü belirtir. Örneğin, bir veritabanı için kaynak türü aşağıdaki gibidir: Microsoft.Sql/Servers/Databases

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

-Sku

SKU özelliklerini temsil eden karma tablo.

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

-Tag

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

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

-TenantLevel

Bu cmdlet'in kiracı düzeyinde çalıştığını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
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

Hashtable

String

Çıkışlar

PSObject