Delen via


New-AzResourceGroupDeployment

Voegt een Azure-implementatie aan een resourcegroep toe.

Syntaxis

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet New-AzResourceGroupDeployment 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-AzResource. 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. 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

New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

Met deze opdracht maakt u een nieuwe implementatie met behulp van een aangepaste sjabloon en een sjabloonbestand op schijf, met de parameter gedefinieerde tags. 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.

Voorbeeld 2: Een aangepast sjabloonobject en parameterbestand gebruiken om een implementatie te maken

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

Met deze opdracht maakt u een nieuwe implementatie met behulp van een aangepast bestand en een sjabloonbestand op schijf dat is geconverteerd naar een hashtabel in het geheugen. Met de eerste twee opdrachten wordt de tekst voor het sjabloonbestand op schijf gelezen en geconverteerd naar een hashtabel in het geheugen. De laatste opdracht maakt gebruik van de parameter TemplateObject om de hashtabel en de parameter TemplateParameterFile op te geven om een bestand op te geven dat parameters en parameterwaarden bevat.

Voorbeeld 3

Voegt een Azure-implementatie aan een resourcegroep toe. (automatisch gegenereerd)

New-AzResourceGroupDeployment -DeploymentDebugLogLevel RequestContent -Name mynewstorageaccount -ResourceGroupName 'ContosoEngineering' -TemplateFile 'D:\Azure\Templates\EngineeringSite.json' -TemplateParameterObject <Hashtable>

Voorbeeld 4: Een sjabloon implementeren die is opgeslagen in een niet-openbaar opslagaccount met behulp van een URI en EEN SAS-token

New-AzResourceGroupDeployment -ResourceGroupName "RGName" -TemplateUri "https://example.com/example.json" -QueryString "foo"

Met deze opdracht maakt u een nieuwe implementatie met behulp van de sjabloon in TemplateUri die niet openbaar is en waarvoor een tokenparameter is vereist voor toegang die zou worden opgegeven met behulp van de parameter QueryString. Als u deze opdracht uitvoert, wordt de sjabloon effectief geopend met behulp van de URL https://example.com/example.json?foo. Dit kan worden gebruikt als u een sjabloon in een opslagaccount wilt gebruiken door het SAS-token op te geven als querystring

Voorbeeld 5: Een BICEPPARAM-bestand gebruiken om een implementatie te maken

New-AzResourceGroupDeployment -ResourceGroupName "RGName"  -TemplateParameterFile "./parameters.bicepparam"

Met deze opdracht maakt u een nieuwe implementatie in het bereik van de resourcegroep met behulp van een BICEPPARAM-bestand op schijf. De opdracht maakt gebruik van de parameter TemplateParameterFile om een BICEPPARAM-bestand op te geven.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AuxTenant

Aux-tenant-id's voor implementaties tussen tenants

Type:String[]
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:AzContext, 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
Geaccepteerde waarden:RequestContent, ResponseContent, All, None
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: In de volledige modus verwijdert Resource Manager resources die aanwezig zijn in de resourcegroep, maar die niet zijn opgegeven in de sjabloon.
  • Incrementeel: 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
Geaccepteerde waarden:Incremental, Complete
Position:Named
Default value:Incremental
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de implementatie die wordt gemaakt. Als dit niet is opgegeven, wordt standaard de naam van het sjabloonbestand opgegeven wanneer een sjabloonbestand wordt opgegeven; is standaard ingesteld op het huidige tijdstip waarop een sjabloonobject wordt opgegeven, bijvoorbeeld '20131223140835'.

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

-ProceedIfNoChange

Vraag niet om bevestiging als er geen wijzigingen zijn in het What-If-resultaat. Van toepassing wanneer de schakeloptie -Confirm is ingesteld.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-QueryString

De querytekenreeks (bijvoorbeeld een SAS-token) die moet worden gebruikt met de parameter TemplateUri. Zou worden gebruikt in het geval van gekoppelde sjablonen

Type:String
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

-SkipTemplateParameterPrompt

Slaat de dynamische PowerShell-parameterverwerking over die controleert of de opgegeven sjabloonparameter alle benodigde parameters bevat die door de sjabloon worden gebruikt. Met deze controle wordt de gebruiker gevraagd een waarde op te geven voor de ontbrekende parameters, maar als u de parameter -SkipTemplateParameterPrompt opgeeft, wordt deze prompt genegeerd en wordt deze fout onmiddellijk genegeerd als er geen parameter in de sjabloon is gebonden. Voor niet-interactieve scripts kan -SkipTemplateParameterPrompt worden opgegeven om een beter foutbericht te geven in het geval dat niet aan alle vereiste parameters wordt voldaan.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

De tags die moeten worden geplaatst voor de implementatie.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TemplateFile

Hiermee geeft u het volledige pad van een aangepast sjabloonbestand. Ondersteund sjabloonbestandstype: json en bicep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TemplateObject

Een hash-tabel die de sjabloon vertegenwoordigt.

Type:Hashtable
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_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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TemplateParameterUri

Hiermee geeft u de URI van een sjabloonparametersbestand. Wanneer u TemplateParameterUri gebruikt, worden alle dynamische parameters die u gebruikt, genegeerd. Als u dynamische parameters wilt gebruiken, moet u in plaats daarvan de parameter TemplateParameterFile gebruiken

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TemplateSpecId

Resource-id van de templateSpec die moet worden geïmplementeerd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TemplateUri

Hiermee geeft u de URI van een aangepast 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:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIfExcludeChangeType

Door komma's gescheiden resourcewijzigingstypen die moeten worden uitgesloten van What-If-resultaten. Van toepassing wanneer de schakeloptie -WhatIf of -Confirm is ingesteld.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIfResultFormat

De what-if-resultaatindeling.

Type:WhatIfResultFormat
Geaccepteerde waarden:ResourceIdOnly, FullResourcePayloads
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

DeploymentMode

Hashtable

Uitvoerwaarden

PSResourceGroupDeployment