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.
Syntaxis
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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AsJob
Cmdlet op de achtergrond uitvoeren
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Type: | IAzureContextContainer |
Aliassen: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam op van de implementatie van de resourcegroep die moet worden gemaakt.
Type: | String |
Aliassen: | DeploymentName |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep die moet worden geïmplementeerd.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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_Tables
u .
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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TemplateParameterUri
Hiermee geeft u de URI van een sjabloonparametersbestand.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
None
Uitvoerwaarden
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment