New-AzureRmDeployment
Een implementatie maken
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-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterFile <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterUri <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateParameterUri <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-AsJob]
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de cmdlet New-AzureRmDeployment wordt een implementatie toegevoegd aan het huidige abonnementsbereik. Dit omvat de resources die nodig zijn voor de implementatie.
Een Azure-resource is een door de gebruiker beheerde Azure-entiteit. Een resource kan zich in een resourcegroep bevinden, zoals databaseserver, database, website, virtuele machine of opslagaccount. Of het kan een resource op abonnementsniveau zijn, zoals roldefinitie, beleidsdefinitie, enzovoort.
Als u resources wilt toevoegen aan een resourcegroep, gebruikt u new-AzureRmDeployment waarmee een implementatie in een resourcegroep wordt gemaakt. Met de cmdlet New-AzureRmDeployment maakt u een implementatie op het huidige abonnementsbereik, waarmee resources op abonnementsniveau worden geïmplementeerd.
Als u een implementatie bij een abonnement wilt toevoegen, geeft u de locatie en een sjabloon op. De locatie vertelt Azure Resource Manager waar de implementatiegegevens moeten worden opgeslagen. De sjabloon is een JSON-tekenreeks die afzonderlijke resources bevat die moeten worden geïmplementeerd. De sjabloon bevat tijdelijke aanduidingen voor parameters voor vereiste resources en configureerbare eigenschapswaarden, zoals namen en grootten.
Als u een aangepaste sjabloon wilt gebruiken voor de implementatie, geeft u de parameter TemplateFile of TemplateUri-parameter 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-AzureRmDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -TemplateVersion "2.1"
Met deze opdracht maakt u een nieuwe implementatie op het huidige abonnementsbereik 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. De parameter TemplateVersion wordt gebruikt om de versie van de sjabloon op te geven.
Parameters
-ApiVersion
Wanneer deze is ingesteld, geeft u de versie van de resourceprovider-API aan die moet worden gebruikt. Als deze niet is opgegeven, wordt de API-versie automatisch bepaald als de meest recente beschikbare versie.
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: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliassen: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DeploymentDebugLogLevel
Het foutopsporingslogboekniveau van de implementatie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Location
De locatie voor het opslaan van implementatiegegevens.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Name
De naam van de implementatie die wordt gemaakt. Alleen geldig wanneer een sjabloon wordt gebruikt. Wanneer een sjabloon wordt gebruikt en de gebruiker geen implementatienaam opgeeft, gebruikt u de huidige tijd, zoals '20131223140835'.
Type: | String |
Aliassen: | DeploymentName |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Pre
Wanneer deze is ingesteld, geeft u aan dat de cmdlet api-versies van de voorlopige versie moet gebruiken wanneer automatisch wordt bepaald welke versie moet worden gebruikt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TemplateFile
Lokaal pad naar het sjabloonbestand.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TemplateParameterFile
Een bestand met de sjabloonparameters.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TemplateParameterObject
Een hash-tabel die de parameters vertegenwoordigt.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TemplateParameterUri
Uri naar het sjabloonparameterbestand.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TemplateUri
Uri naar het sjabloonbestand.
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: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
System.Collections.Hashtable