New-AzureRmResourceGroupDeployment
Přidá nasazení Azure do skupiny prostředků.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
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
Rutina New-AzureRmResourceGroupDeployment přidá nasazení do existující skupiny prostředků. To zahrnuje prostředky, které nasazení vyžaduje. Prostředek Azure je entita Azure spravovaná uživatelem, jako je databázový server, databáze, web, virtuální počítač nebo účet úložiště. Skupina prostředků Azure je kolekce prostředků Azure nasazených jako jednotka, jako je web, databázový server a databáze, které jsou potřeba pro finanční web. Nasazení skupiny prostředků pomocí šablony přidá prostředky do skupiny prostředků a publikuje je, aby byly dostupné v Azure. Pokud chcete přidat prostředky do skupiny prostředků bez použití šablony, použijte rutinu New-AzureRmResource. Pokud chcete přidat nasazení skupiny prostředků, zadejte název existující skupiny prostředků a šablonu skupiny prostředků. Šablona skupiny prostředků je řetězec JSON, který představuje skupinu prostředků pro složitou cloudovou službu, například webový portál. Šablona obsahuje zástupné symboly parametrů pro požadované prostředky a konfigurovatelné hodnoty vlastností, jako jsou názvy a velikosti. Mnoho šablon najdete v galerii šablon Azure nebo si můžete vytvořit vlastní šablony. K vyhledání šablony v galerii můžete použít rutinu Get-AzureRmResourceGroupGalleryTemplate . Pokud chcete k vytvoření skupiny prostředků použít vlastní šablonu, zadejte parametr TemplateFile nebo parametr TemplateUri . Každá šablona má parametry pro konfigurovatelné vlastnosti. Chcete-li zadat hodnoty parametrů šablony, zadejte Parametr TemplateParameterFile nebo TemplateParameterObject parametr. Případně můžete použít parametry šablony, které se dynamicky přidají do příkazu při zadání šablony. Pokud chcete použít dynamické parametry, zadejte je na příkazovém řádku nebo zadejte znaménko minus (-) k označení parametru a pomocí klávesy Tab můžete cyklicky procházet dostupnými parametry. Hodnoty parametrů šablony, které zadáte na příkazovém řádku, mají přednost před hodnotami v objektu nebo souboru parametru šablony.
Příklady
Příklad 1: Vytvoření nasazení pomocí vlastní šablony a souboru parametrů
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"
Tento příkaz vytvoří nové nasazení pomocí vlastní šablony a souboru šablony na disku. Příkaz pomocí parametru TemplateFile určí šablonu a parametr TemplateParameterFile k určení souboru, který obsahuje parametry a hodnoty parametrů.
Parametry
-ApiVersion
Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Spuštění rutiny na pozadí
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
výchozí hodnota: | False |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentDebugLogLevel
Určuje úroveň protokolu ladění. Tento parametr přijímá tyto hodnoty:
- RequestContent
- ResponseContent
- Vše
- Nic
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mode
Určuje režim nasazení. Tento parametr přijímá tyto hodnoty:
- Dokončit
- Inkrementální v úplném režimu Resource Manager odstraní prostředky, které existují ve skupině prostředků, ale nejsou zadané v šabloně. V přírůstkovém režimu Resource Manager ponechá nezměněné prostředky, které existují ve skupině prostředků, ale nejsou zadané v šabloně.
Typ: | DeploymentMode |
Position: | Named |
výchozí hodnota: | Incremental |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Určuje název nasazení skupiny prostředků, která se má vytvořit.
Typ: | String |
Aliases: | DeploymentName |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Určuje název skupiny prostředků, která se má nasadit.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollBackDeploymentName
Vrácení zpět k úspěšnému nasazení s daným názvem ve skupině prostředků by se nemělo používat, pokud se použije -RollbackToLastDeployment.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollbackToLastDeployment
Vrácení zpět k poslednímu úspěšnému nasazení ve skupině prostředků by nemělo být k dispozici, pokud se použije -RollBackDeploymentName.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Určuje úplnou cestu k souboru šablony JSON. Může se jednat o vlastní šablonu nebo šablonu galerie uloženou jako soubor JSON, například šablonu vytvořenou pomocí rutiny Save-AzureRmResourceGroupGalleryTemplate .
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Určuje úplnou cestu k souboru JSON, který obsahuje názvy a hodnoty parametrů šablony. Pokud šablona obsahuje parametry, je nutné zadat hodnoty parametrů pomocí parametru TemplateParameterFile nebo TemplateParameterObject parametru. Parametry šablony se dynamicky přidají do příkazu při zadání šablony. Pokud chcete použít dynamické parametry, zadejte znaménko minus (-) k označení názvu parametru a pak pomocí klávesy Tab cyklicky procházejte dostupnými parametry.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Určuje tabulku hash názvů a hodnot parametrů šablony.
Nápovědu k tabulkám hash v prostředí Windows PowerShell pište Get-Help about_Hash_Tables
.
Pokud šablona obsahuje parametry, musíte zadat hodnoty parametrů.
Parametry šablony se dynamicky přidají do příkazu při zadání šablony.
Typ: | Hashtable |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
Určuje identifikátor URI souboru parametrů šablony.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
Určuje identifikátor URI souboru šablony JSON. Tento soubor může být vlastní šablona nebo šablona galerie, která je uložena jako soubor JSON, například pomocí Save-AzureRmResourceGroupGalleryTemplate.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
výchozí hodnota: | False |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None
Výstupy
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment