New-AzureRmDeployment

Başvuru

Modül:: AzureRM.Resources

Dağıtım oluşturma

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.

Syntax

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmDeployment 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-AzureRmDeployment komutunu kullanın. New-AzureRmDeployment 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

PS C:\>New-AzureRmDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -TemplateVersion "2.1"

Bu komut, ö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. Şablonun sürümünü belirtmek için TemplateVersion parametresini kullanır.

Parametreler

-ApiVersion

Ayarlandığında, kullanılacak kaynak sağlayıcısı API'sinin sürümünü gösterir. Belirtilmezse, API sürümü otomatik olarak en son kullanılabilir sürüm olarak belirlenir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentDebugLogLevel

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Dağıtım verilerini depolama konumu.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Oluşturacağı dağıtımın adı. Yalnızca şablon kullanıldığında geçerlidir. Şablon kullanıldığında, kullanıcı bir dağıtım adı belirtmezse, "20131223140835" gibi geçerli saati kullanın.

Type:	String
Aliases:	DeploymentName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateFile

Şablon dosyasının yerel yolu.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterFile

Şablon parametrelerini içeren bir dosya.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterObject

Parametreleri temsil eden karma tablo.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterUri

Şablon parametre dosyasına Uri.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateUri

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

String

Hashtable

Çıkışlar

PSDeployment

Aracılığıyla paylaş