New-AzureRmResourceGroupDeployment
Bir kaynak grubuna Azure dağıtımı ekler.
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-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzureRmResourceGroupDeployment cmdlet'i mevcut bir kaynak grubuna dağıtım ekler. Bu, dağıtımın gerektirdiği kaynakları içerir. Azure kaynağı veritabanı sunucusu, veritabanı, web sitesi, sanal makine veya Depolama hesabı gibi kullanıcı tarafından yönetilen bir Azure varlığıdır. Azure kaynak grubu, bir finansal web sitesi için gereken web sitesi, veritabanı sunucusu ve veritabanları gibi birim olarak dağıtılan Azure kaynaklarından oluşan bir koleksiyondur. Kaynak grubu dağıtımı, kaynak grubuna kaynak eklemek için bir şablon kullanır ve bunları Azure'da kullanılabilir olacak şekilde yayımlar. Şablon kullanmadan kaynak grubuna kaynak eklemek için New-AzureRmResource cmdlet'ini kullanın. Kaynak grubu dağıtımı eklemek için var olan bir kaynak grubunun adını ve kaynak grubu şablonunu belirtin. Kaynak grubu şablonu, web portalı gibi karmaşık bir bulut tabanlı hizmet için kaynak grubunu temsil eden 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. Azure şablon galerisinde birçok şablon bulabilir veya kendi şablonlarınızı oluşturabilirsiniz. Galeride şablon bulmak için Get-AzureRmResourceGroupGalleryTemplate cmdlet'ini kullanabilirsiniz. Kaynak grubu oluşturmak üzere ö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-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"
Bu komut, diskte özel bir şablon ve şablon dosyası kullanarak 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.
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.
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: | False |
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
Hata ayıklama günlüğü düzeyini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- RequestContent
- ResponseContent
- Tümünü
- Hiçbiri
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mode
Dağıtım modunu belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Tamamla
- Artımlı Tam modda Resource Manager, kaynak grubunda var olan ancak şablonda belirtilmeyen kaynakları siler. Artımlı modda, Resource Manager kaynak grubunda var olan ancak şablonda belirtilmeyen değişmemiş kaynakları bırakır.
Type: | DeploymentMode |
Position: | Named |
Default value: | Incremental |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Oluşturulacak kaynak grubu dağıtımının adını belirtir.
Type: | String |
Aliases: | DeploymentName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Dağıtılacak kaynak grubunun adını belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollBackDeploymentName
Kaynak grubunda verilen adla başarılı dağıtıma geri alma, -RollbackToLastDeployment kullanılırsa kullanılmamalıdır.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollbackToLastDeployment
-RollBackDeploymentName kullanılırsa, kaynak grubundaki son başarılı dağıtıma geri alma mevcut olmamalıdır.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
JSON şablon dosyasının tam yolunu belirtir. Bu özel bir şablon veya Save-AzureRmResourceGroupGalleryTemplate cmdlet'i kullanılarak oluşturulan bir JSON dosyası olarak kaydedilmiş bir galeri şablonu olabilir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Şablon parametrelerinin adlarını ve değerlerini içeren bir JSON dosyasının tam yolunu belirtir. Bir şablonun parametreleri varsa, parametre değerlerini TemplateParameterFile parametresiyle veya TemplateParameterObject parametresiyle belirtmeniz gerekir. Şablon belirttiğinizde şablon parametreleri komuta dinamik olarak eklenir. Dinamik parametreleri kullanmak için, bir parametre adını belirtmek için eksi işareti (-) yazın ve kullanılabilir parametreler arasında geçiş yapmak için Sekme tuşunu kullanın.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Şablon parametre adlarının ve değerlerinin karma tablosunu belirtir.
Windows PowerShell'de karma tablolarla ilgili yardım için yazın Get-Help about_Hash_Tables
.
Şablonun parametreleri varsa parametre değerlerini belirtmeniz gerekir.
Şablon belirttiğinizde şablon parametreleri komuta dinamik olarak eklenir.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
Şablon parametreleri dosyasının URI'sini belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
JSON şablon dosyasının URI'sini belirtir. Bu dosya, Save-AzureRmResourceGroupGalleryTemplate kullanılarak JSON dosyası olarak kaydedilen özel bir şablon veya galeri şablonu olabilir.
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
None
Çıkışlar
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment