Test-AzResourceGroupDeployment
Ověří nasazení skupiny prostředků.
Syntax
ByTemplateFileWithNoParameters (Výchozí)
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
Rutina Test-AzResourceGroupDeployment určuje, jestli je platná šablona nasazení skupiny prostředků Azure a její hodnoty parametrů.
Příklady
Příklad 1: Testování nasazení pomocí objektu vlastní šablony a souboru parametrů
$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"
Tento příkaz otestuje nasazení v dané skupině prostředků pomocí hashtable v paměti vytvořeného z daného souboru šablony a souboru parametrů.
Příklad 2: Testování nasazení prostřednictvím souboru šablony a souboru parametrů
Test-AzResourceGroupDeployment -ResourceGroupName testRG01 -TemplateFile "D:\Azure\Templates\sampleDeploymentTemplate.json" -TemplateParameterFile "D:\Azure\Templates\sampleDeploymentTemplateParams.json"
Tento příkaz otestuje nasazení v dané skupině prostředků a prostředku pomocí zadaného souboru šablony a souboru parametrů.
Příklad 3: Ověření nasazení pomocí souboru .bicepparam
Test-AzResourceGroupDeployment -ResourceGroupName "myRG1" -TemplateParameterFile "./parameters.bicepparam"
Tento příkaz ověří nasazení v oboru skupiny prostředků pomocí souboru .bicepparam na disku.
Příkaz používá parametr TemplateParameterFile k určení souboru .bicepparam.
Parametry
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Vlastnosti parametru
Typ: IAzureContextContainer
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: AzContext, AzureRmContext, AzureCredential
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Mode
Určuje režim nasazení.
Přijatelné hodnoty pro tento parametr jsou:
Vlastnosti parametru
Typ: DeploymentMode
Default value: None
Přípustné hodnoty: Incremental, Complete
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-Pre
Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-QueryString
Řetězec dotazu (například token SAS), který se má použít s parametrem TemplateUri. Použije se v případě propojených šablon.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ResourceGroupName
Určuje název skupiny prostředků, která se má testovat.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-RollBackDeploymentName
Vrácení zpět k úspěšnému nasazení s daným názvem ve skupině prostředků by se nemělo používat, pokud se -RollbackToLastDeployment používá.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-RollbackToLastDeployment
Vrácení zpět k poslednímu úspěšnému nasazení ve skupině prostředků by nemělo být k dispozici, pokud se -RollBackDeploymentName použije.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-SkipTemplateParameterPrompt
Přeskočí zpracování dynamického parametru PowerShellu, které kontroluje, jestli zadaný parametr šablony obsahuje všechny nezbytné parametry, které šablona používá. Tato kontrola by uživateli zobrazila výzvu k zadání hodnoty chybějících parametrů, ale za předpokladu, že -SkipTemplateParameterPrompt bude tuto výzvu ignorovat a okamžitě se zobrazí chyba, pokud nebyl v šabloně nalezen parametr vázán. Pro neinteraktivní skripty je možné poskytnout -SkipTemplateParameterPrompt, aby se v případě, že nejsou splněny všechny požadované parametry, zobrazily lepší chybovou zprávu.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-SuppressDiagnostics
Po nastavení se u platných nasazení nezobrazí diagnostika ověření.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-TemplateFile
Určuje úplnou cestu k souboru šablony. Podporovaný typ souboru šablony: json a bicep.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateFileWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateObject
Tabulka hash, která představuje šablonu.
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterFile
Určuje úplnou cestu k souboru JSON, který obsahuje názvy a hodnoty parametrů šablony.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParams
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByParameterFileWithNoTemplate
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterObject
Určuje tabulku hash názvů a hodnot parametrů šablony.
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterUri
Určuje identifikátor URI souboru parametrů šablony.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateSpecId
ID prostředku šablonySpec, který se má nasadit.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParams
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceId
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateUri
Určuje identifikátor URI souboru šablony.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateUriAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-ValidationLevel
Nastaví úroveň ověřování pro ověření a citlivostní ověření. ValidationLevel může být Template(Skips provider validation), Provider(Provádí úplné ověření) nebo ProviderNoRbac(Provádí úplné ověření pomocí kontrol čtení RBAC místo kontrol zápisu RBAC pro ověření zprostředkovatele).
Vlastnosti parametru
Typ: String
Default value: None(Provider)
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Microsoft.Azure.Management.ResourceManager.Models.DeploymentMode
Výstupy