Aracılığıyla paylaş


New-AzDeployment

Geçerli abonelik kapsamında bir dağıtım oluşturun.

Sözdizimi

New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-ProceedIfNoChange]
   [-AsJob]
   [-QueryString <String>]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzDeployment cmdlet'i geçerli abonelik kapsamına bir dağıtım ekler. Bu, dağıtımın gerektirdiği kaynakları içerir.

Azure kaynağı, kullanıcı tarafından yönetilen bir Azure varlığıdır. Kaynak, veritabanı sunucusu, veritabanı, web sitesi, sanal makine veya Depolama hesabı gibi bir kaynak grubunda bulunabilir. Alternatif olarak, rol tanımı, ilke tanımı vb. abonelik düzeyinde bir kaynak da olabilir.

Kaynak grubuna kaynak eklemek için, bir kaynak grubunda dağıtım oluşturan New-AzResourceGroupDeployment komutunu kullanın. New-AzDeployment cmdlet'i, abonelik düzeyi kaynaklarını dağıtan geçerli abonelik kapsamında bir dağıtım oluşturur.

Abonelikte dağıtım eklemek için konumu ve şablonu belirtin. Konum, Azure Resource Manager'a dağıtım verilerinin depolandığı yeri bildirir. Şablon, dağıtılacak tek tek kaynakları içeren bir JSON dizesidir. Şablon, gerekli kaynaklar ve adlar ve boyutlar gibi yapılandırılabilir özellik değerleri için parametre yer tutucuları içerir.

Dağıtım için özel bir şablon kullanmak için TemplateFile parametresini veya TemplateUri parametresini belirtin. Her şablonun yapılandırılabilir özellikler için parametreleri vardır. Şablon parametrelerinin değerlerini belirtmek için TemplateParameterFile parametresini veya TemplateParameterObject parametresini belirtin. Alternatif olarak, bir şablon belirtirken komuta dinamik olarak eklenen şablon parametrelerini kullanabilirsiniz. Dinamik parametreleri kullanmak için, bunları komut istemine yazın veya bir parametreyi belirtmek için eksi işareti (-) yazın ve kullanılabilir parametreler arasında geçiş yapmak için Sekme tuşunu kullanın. Komut isteminde girdiğiniz şablon parametresi değerleri, şablon parametre nesnesi veya dosyasındaki değerlerden önceliklidir.

Örnekler

Örnek 1: Dağıtım oluşturmak için özel şablon ve parametre dosyası kullanma

New-AzDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

Bu komut, tanımlı etiketler parametresiyle özel bir şablon ve diskte şablon dosyası kullanarak geçerli abonelik kapsamında yeni bir dağıtım oluşturur. komutu, template parametresini belirtmek için TemplateFile parametresini, parametre ve parametre değerleri içeren bir dosya belirtmek için TemplateParameterFile parametresini kullanır.

Örnek 2: URI ve SAS belirteci kullanarak genel olmayan bir depolama hesabında depolanan bir şablonu dağıtma

New-AzDeployment -Location "West US" -TemplateUri "https://example.com/example.json" -QueryString "foo"

Bu komut, TemplateUri'deki şablonu kullanarak yeni bir dağıtım oluşturur. Bu, genel olmayan ve erişmek için QueryString parametresi kullanılarak sağlanacak bir belirteç parametresi gerektirir. Bu komutun çalıştırılması url'sini https://example.com/example.json?fookullanarak şablona etkili bir şekilde erişir. Sas belirtecini QueryString olarak sağlayarak bir depolama hesabında şablon kullanmak istiyorsanız bu kullanılabilir

Örnek 3: Dağıtım oluşturmak için özel şablon nesnesi ve parametre dosyası kullanma

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzDeployment -Location "West US" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

Bu komut, diskteki özel bir şablon ve bellek içi karma tabloya dönüştürülmüş bir şablon dosyası kullanarak geçerli abonelik kapsamında yeni bir dağıtım oluşturur. İlk iki komut, diskteki şablon dosyasının metnini okur ve bunu bellek içi karma tabloya dönüştürür. Son komut, bu hashtable'ı belirtmek için TemplateObject parametresini ve parametre ve parametre değerleri içeren bir dosya belirtmek için TemplateParameterFile parametresini kullanır.

Örnek 4: Dağıtım oluşturmak için .bicepparam dosyası kullanma

New-AzDeployment -Location "West US" -TemplateParameterFile "./parameters.bicepparam"

Bu komut, diskte bir .bicepparam dosyası kullanarak geçerli abonelik kapsamında yeni bir dağıtım oluşturur. Komut, bir .bicepparam dosyası belirtmek için TemplateParameterFile parametresini kullanır.

Parametreler

-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:None
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

-DeploymentDebugLogLevel

Dağıtım hata ayıklama günlüğü düzeyi.

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

-Location

Dağıtım verilerini depolama konumu.

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

-Name

Oluşturacağı dağıtımın adı. Belirtilmezse, bir şablon dosyası sağlandığında varsayılan olarak şablon dosyası adını kullanır; varsayılan olarak bir şablon nesnesi sağlandığında geçerli saati kullanır; örneğin, "20131223140835".

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

-Pre

Ayarlandığında, cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlerken yayın öncesi API sürümlerini kullanması gerektiğini belirtir.

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

-ProceedIfNoChange

What-If sonucunda herhangi bir değişiklik yoksa onay istemeyin. -Confirm anahtarı ayarlandığında geçerlidir.

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

-QueryString

TemplateUri parametresiyle kullanılacak sorgu dizesi (örneğin, sas belirteci). Bağlantılı şablonlar söz konusu olduğunda kullanılır

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

-SkipTemplateParameterPrompt

Sağlanan şablon parametresinin şablon tarafından kullanılan tüm gerekli parametreleri içerip içermediğini denetleyerek PowerShell dinamik parametre işlemesini atlar. Bu denetim kullanıcıdan eksik parametreler için bir değer sağlamasını ister, ancak -SkipTemplateParameterPrompt değerinin sağlanması bu istemi yoksayar ve şablonda bir parametrenin bağlı olmadığı tespit edilirse hemen hata verir. Etkileşimli olmayan betikler için, tüm gerekli parametrelerin karşılanmaması durumunda daha iyi bir hata iletisi sağlamak için -SkipTemplateParameterPrompt sağlanabilir.

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

-Tag

Dağıtıma konulacak etiketler.

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

-TemplateFile

Şablon dosyasının yerel yolu. Desteklenen şablon dosya türü: json ve bicep.

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

-TemplateObject

Şablonu temsil eden karma tablo.

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

-TemplateParameterFile

Şablon için kullanılacak parametre dosyası.

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

-TemplateParameterObject

Parametreleri temsil eden karma tablo.

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

-TemplateParameterUri

Şablon parametre dosyasına Uri.

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

-TemplateSpecId

Dağıtılacak templateSpec öğesinin kaynak kimliği.

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

-TemplateUri

Şablon dosyasının Uri'sini seçin.

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

-WhatIfExcludeChangeType

Durum sonuçlarından dışlanacak virgülle ayrılmış kaynak değişikliği türleri. -WhatIf veya -Confirm anahtarı ayarlandığında geçerlidir.

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

-WhatIfResultFormat

What-If sonuç biçimi.

Tür:WhatIfResultFormat
Kabul edilen değerler:ResourceIdOnly, FullResourcePayloads
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

Hashtable

String

Çıkışlar

PSDeployment