New-AzureRmResourceGroupDeployment
Voegt een Azure-implementatie aan een resourcegroep toe.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
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
De cmdlet New-AzureRmResourceGroupDeployment voegt een implementatie toe aan een bestaande resourcegroep. Dit omvat de resources die nodig zijn voor de implementatie. Een Azure-resource is een door de gebruiker beheerde Azure-entiteit, zoals een databaseserver, database, website, virtuele machine of opslagaccount. Een Azure-resourcegroep is een verzameling Azure-resources die zijn geïmplementeerd als een eenheid, zoals de website, databaseserver en databases die vereist zijn voor een financiële website. Een implementatie van een resourcegroep maakt gebruik van een sjabloon om resources toe te voegen aan een resourcegroep en publiceert deze zodat ze beschikbaar zijn in Azure. Als u resources wilt toevoegen aan een resourcegroep zonder een sjabloon, gebruikt u de cmdlet New-AzureRmResource. Als u een implementatie van een resourcegroep wilt toevoegen, geeft u de naam van een bestaande resourcegroep en een resourcegroepsjabloon op. Een resourcegroepsjabloon is een JSON-tekenreeks die een resourcegroep vertegenwoordigt voor een complexe cloudservice, zoals een webportal. De sjabloon bevat tijdelijke aanduidingen voor parameters voor vereiste resources en configureerbare eigenschapswaarden, zoals namen en grootten. U vindt veel sjablonen in de Galerie met Azure-sjablonen of u kunt uw eigen sjablonen maken. U kunt de cmdlet Get-AzureRmResourceGroupGalleryTemplate gebruiken om een sjabloon in de galerie te vinden. Als u een aangepaste sjabloon wilt gebruiken om een resourcegroep te maken, geeft u de parameter TemplateFile of De parameter TemplateUri op. Elke sjabloon heeft parameters voor configureerbare eigenschappen. Als u waarden voor de sjabloonparameters wilt opgeven, geeft u de parameter TemplateParameterFile of de parameter TemplateParameterObject op. U kunt ook de sjabloonparameters gebruiken die dynamisch aan de opdracht worden toegevoegd wanneer u een sjabloon opgeeft. Als u dynamische parameters wilt gebruiken, typt u deze bij de opdrachtprompt of typt u een minteken (-) om een parameter aan te geven en gebruikt u de Tab-toets om door de beschikbare parameters te bladeren. Sjabloonparameterwaarden die u invoert bij de opdrachtprompt hebben voorrang op waarden in een sjabloonparameterobject of -bestand.
Voorbeelden
Voorbeeld 1: Een aangepast sjabloon en parameterbestand gebruiken om een implementatie te maken
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Met deze opdracht maakt u een nieuwe implementatie met behulp van een aangepaste sjabloon en een sjabloonbestand op schijf. De opdracht maakt gebruik van de parameter TemplateFile om de sjabloon en de parameter TemplateParameterFile op te geven om een bestand op te geven dat parameters en parameterwaarden bevat.
Parameters
-ApiVersion
Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AsJob
Cmdlet op de achtergrond uitvoeren
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentDebugLogLevel
Hiermee geeft u een foutopsporingslogboekniveau op. De aanvaardbare waarden voor deze parameter zijn:
- RequestContent
- ResponseContent
- Alle
- Geen
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mode
Hiermee geeft u de implementatiemodus. De aanvaardbare waarden voor deze parameter zijn:
- Voltooid
- Incrementeel in de volledige modus verwijdert Resource Manager resources die aanwezig zijn in de resourcegroep, maar die niet zijn opgegeven in de sjabloon. In de incrementele modus laat Resource Manager ongewijzigde resources over die aanwezig zijn in de resourcegroep, maar die niet zijn opgegeven in de sjabloon.
| Type: | DeploymentMode |
| Position: | Named |
| Default value: | Incremental |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam op van de implementatie van de resourcegroep die moet worden gemaakt.
| Type: | String |
| Aliases: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep die moet worden geïmplementeerd.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollBackDeploymentName
Terugdraaien naar de geslaagde implementatie met de opgegeven naam in de resourcegroep, mag niet worden gebruikt als -RollbackToLastDeployment wordt gebruikt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollbackToLastDeployment
Terugdraaien naar de laatste geslaagde implementatie in de resourcegroep, mag niet aanwezig zijn als -RollBackDeploymentName wordt gebruikt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateFile
Hiermee geeft u het volledige pad van een JSON-sjabloonbestand. Dit kan een aangepaste sjabloon zijn of een galeriesjabloon die is opgeslagen als een JSON-bestand, zoals een sjabloon die is gemaakt met behulp van de cmdlet Save-AzureRmResourceGroupGalleryTemplate .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterFile
Hiermee geeft u het volledige pad van een JSON-bestand dat de namen en waarden van de sjabloonparameters bevat. Als een sjabloon parameters heeft, moet u de parameterwaarden opgeven met de parameter TemplateParameterFile of de parameter TemplateParameterObject . Sjabloonparameters worden dynamisch toegevoegd aan de opdracht wanneer u een sjabloon opgeeft. Als u de dynamische parameters wilt gebruiken, typt u een minteken (-) om een parameternaam aan te geven en gebruikt u vervolgens de Tab-toets om door de beschikbare parameters te bladeren.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterObject
Hiermee geeft u een hash-tabel met sjabloonparameternamen en -waarden op.
Voor hulp bij hash-tabellen in Windows PowerShell typt Get-Help about_Hash_Tablesu .
Als een sjabloon parameters bevat, moet u parameterwaarden opgeven.
Sjabloonparameters worden dynamisch toegevoegd aan de opdracht wanneer u een sjabloon opgeeft.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterUri
Hiermee geeft u de URI van een sjabloonparametersbestand.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateUri
Hiermee geeft u de URI van een JSON-sjabloonbestand. Dit bestand kan een aangepaste sjabloon of een galeriesjabloon zijn die is opgeslagen als een JSON-bestand, zoals met behulp van Save-AzureRmResourceGroupGalleryTemplate.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
None
Uitvoerwaarden
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment