New-AzureRmResourceGroupDeployment
Přidá nasazení Azure do skupiny prostředků.
Upozorňující
Modul AzureRM PowerShell je 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.
Syntaxe
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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-AsJob
Spuštění rutiny na pozadí
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DeploymentDebugLogLevel
Určuje úroveň protokolu ladění. Tento parametr přijímá tyto hodnoty:
- RequestContent
- ResponseContent
- Všechny
- Nic
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 |
| Default value: | Incremental |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název nasazení skupiny prostředků, která se má vytvořit.
| Typ: | String |
| Aliasy: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků, která se má nasadit.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateParameterUri
Určuje identifikátor URI souboru parametrů šablony.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Výstupy
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment