Test-AzResourceGroupDeployment
Hiermee valideert u de implementatie van een resourcegroep.
Syntax
ByTemplateFileWithNoParameters (Standaard)
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateFile <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterObject
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterObject
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterObject
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParamsObject
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterFile
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterFile
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterFile <String>
-TemplateFile <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterFile
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterFile <String>
-TemplateUri <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParams
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByParameterFileWithNoTemplate
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterFile <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterUri
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterUri
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterUri <String>
-TemplateFile <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterUri
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterUri <String>
-TemplateUri <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParamsUri
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectWithNoParameters
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateObject <Hashtable>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriWithNoParameters
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateUri <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceId
Test-AzResourceGroupDeployment
-ResourceGroupName <String>
-TemplateSpecId <String>
[-Mode <DeploymentMode>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-QueryString <String>]
[-ValidationLevel <String>]
[-SuppressDiagnostics]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
De cmdlet Test-AzResourceGroupDeployment bepaalt of een implementatiesjabloon voor een Azure-resourcegroep en de bijbehorende parameterwaarden geldig zijn.
Voorbeelden
Voorbeeld 1: Implementatie testen met een aangepast sjabloonobject en parameterbestand
$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
Test-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"
Met deze opdracht wordt een implementatie in de opgegeven resourcegroep getest met behulp van de hashtabel in het geheugen die is gemaakt op basis van het opgegeven sjabloonbestand en een parameterbestand.
Voorbeeld 2: Implementatie testen via sjabloonbestand en parameterbestand
Test-AzResourceGroupDeployment -ResourceGroupName testRG01 -TemplateFile "D:\Azure\Templates\sampleDeploymentTemplate.json" -TemplateParameterFile "D:\Azure\Templates\sampleDeploymentTemplateParams.json"
Met deze opdracht wordt een implementatie in de opgegeven resourcegroep en resource getest met behulp van het opgegeven sjabloonbestand en een parameterbestand.
Voorbeeld 3: Een BICEPPARAM-bestand gebruiken om een implementatie te valideren
Test-AzResourceGroupDeployment -ResourceGroupName "myRG1" -TemplateParameterFile "./parameters.bicepparam"
Met deze opdracht wordt de implementatie op het bereik van de resourcegroep gevalideerd met behulp van een BICEPPARAM-bestand op schijf.
De opdracht maakt gebruik van de parameter TemplateParameterFile om een BICEPPARAM-bestand op te geven.
Parameters
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Parametereigenschappen
Type: IAzureContextContainer
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: AzContext, AzureRmContext, AzureCredential
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Mode
Hiermee geeft u de implementatiemodus.
De acceptabele waarden voor deze parameter zijn:
Parametereigenschappen
Type: DeploymentMode
Default value: None
Geaccepteerde waarden: Incremental, Complete
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Pre
Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: 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
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep die moet worden getest.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-RollBackDeploymentName
Terugdraaien naar de geslaagde implementatie met de opgegeven naam in de resourcegroep, mag niet worden gebruikt als -RollbackToLastDeployment wordt gebruikt.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-RollbackToLastDeployment
Terugdraaien naar de laatste geslaagde implementatie in de resourcegroep, mag niet aanwezig zijn als -RollBackDeploymentName wordt gebruikt.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: 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 -SkipTemplateParameterPrompt opgeeft, wordt deze prompt en fout onmiddellijk genegeerd als een parameter niet is gebonden aan de sjabloon. 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.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-SuppressDiagnostics
Wanneer deze is ingesteld, wordt validatiediagnose niet weergegeven voor geldige implementaties.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-TemplateFile
Hiermee geeft u het volledige pad van een sjabloonbestand. Ondersteund sjabloonbestandstype: json en bicep.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateFileWithNoParameters
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateObject
Een hash-tabel die de sjabloon vertegenwoordigt.
Parametereigenschappen
Type: Hashtable
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateObjectAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateObjectAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateObjectAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateObjectWithNoParameters
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateParameterFile
Hiermee geeft u het volledige pad van een JSON-bestand dat de namen en waarden van de sjabloonparameters bevat.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateObjectAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceIdAndParams
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByParameterFileWithNoTemplate
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateParameterObject
Hiermee geeft u een hash-tabel met sjabloonparameternamen en -waarden op.
Parametereigenschappen
Type: Hashtable
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateObjectAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateParameterUri
Hiermee geeft u de URI van een sjabloonparametersbestand.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateObjectAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateFileAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateSpecId
Resource-id van de templateSpec die moet worden geïmplementeerd.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceIdAndParams
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateSpecResourceId
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-TemplateUri
Hiermee geeft u de URI van een sjabloonbestand.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ByTemplateUriAndParameterObject
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriAndParameterFile
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriAndParameterUri
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
ByTemplateUriWithNoParameters
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ValidationLevel
Hiermee stelt u het validatieniveau voor valideren/what-if in. ValidationLevel kan Sjabloon(Validatie van provider overslaan), Provider(Voert volledige validatie) of ProviderNoRbac(Voert volledige validatie uit met behulp van RBAC-leescontroles in plaats van RBAC-schrijfcontroles voor providervalidatie).
Parametereigenschappen
Type: String
Default value: None(Provider)
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
Microsoft.Azure.Management.ResourceManager.Models.DeploymentMode
Uitvoerwaarden