Test-AzResourceGroupDeployment
Convalida una distribuzione di un gruppo di risorse.
Sintassi
ByTemplateFileWithNoParameters (Impostazione predefinita)
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>]
Descrizione
Il cmdlet Test-AzResourceGroupDeployment determina se un modello di distribuzione del gruppo di risorse di Azure e i relativi valori dei parametri sono validi.
Esempio
Esempio 1: Testare la distribuzione con un oggetto modello personalizzato e un file di parametri
$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"
Questo comando testa una distribuzione nel gruppo di risorse specificato usando una tabella hash in memoria creata dal file modello specificato e da un file di parametri.
Esempio 2: Testare la distribuzione tramite file modello e file di parametri
Test-AzResourceGroupDeployment -ResourceGroupName testRG01 -TemplateFile "D:\Azure\Templates\sampleDeploymentTemplate.json" -TemplateParameterFile "D:\Azure\Templates\sampleDeploymentTemplateParams.json"
Questo comando testa una distribuzione nel gruppo di risorse e nella risorsa specificati usando il file modello fornito e un file di parametri.
Esempio 3: Usare un file bicepparam per convalidare una distribuzione
Test-AzResourceGroupDeployment -ResourceGroupName "myRG1" -TemplateParameterFile "./parameters.bicepparam"
Questo comando convalida la distribuzione nell'ambito del gruppo di risorse usando un file bicepparam su disco.
Il comando usa il parametro TemplateParameterFile per specificare un file con estensione bicepparam.
Parametri
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Mode
Specifica la modalità di distribuzione.
I valori accettabili per questo parametro sono:
Proprietà dei parametri
Tipo: DeploymentMode
Valore predefinito: None
Valori accettati: Incremental, Complete
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-Pre
Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-QueryString
Stringa di query (ad esempio, un token di firma di accesso condiviso) da usare con il parametro TemplateUri. Verrebbe usato in caso di modelli collegati
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ResourceGroupName
Specifica il nome del gruppo di risorse da testare.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-RollBackDeploymentName
Eseguire il rollback alla distribuzione con il nome specificato nel gruppo di risorse, non deve essere usato se viene usato -RollbackToLastDeployment.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-RollbackToLastDeployment
Il rollback all'ultima distribuzione riuscita nel gruppo di risorse non deve essere presente se viene usato -RollBackDeploymentName.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-SkipTemplateParameterPrompt
Ignora l'elaborazione dei parametri dinamici di PowerShell che controlla se il parametro del modello fornito contiene tutti i parametri necessari usati dal modello. Questo controllo richiede all'utente di specificare un valore per i parametri mancanti, ma specificando il -SkipTemplateParameterPrompt ignorerà questa richiesta e genererà l'errore immediatamente se non è stato trovato un parametro da associare nel modello. Per gli script non interattivi, è possibile fornire -SkipTemplateParameterPrompt per fornire un messaggio di errore migliore nel caso in cui non siano soddisfatti tutti i parametri obbligatori.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-SuppressDiagnostics
Se impostata, la diagnostica di convalida non verrà visualizzata per le distribuzioni valide.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TemplateFile
Specifica il percorso completo di un file modello. Tipo di file modello supportato: json e bicep.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateFileWithNoParameters
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateObject
Tabella hash che rappresenta il modello.
Proprietà dei parametri
Tipo: Hashtable
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateObjectAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateObjectAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateObjectAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateObjectWithNoParameters
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateParameterFile
Specifica il percorso completo di un file JSON che contiene i nomi e i valori dei parametri del modello.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateObjectAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceIdAndParams
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByParameterFileWithNoTemplate
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateParameterObject
Specifica una tabella hash di nomi e valori dei parametri del modello.
Proprietà dei parametri
Tipo: Hashtable
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateObjectAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceIdAndParamsObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateParameterUri
Specifica l'URI di un file di parametri modello.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateObjectAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateFileAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceIdAndParamsUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateSpecId
ID risorsa del modelloSpec da distribuire.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateSpecResourceIdAndParamsObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceIdAndParams
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceIdAndParamsUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateSpecResourceId
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-TemplateUri
Specifica l'URI di un file modello.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
ByTemplateUriAndParameterObject
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriAndParameterFile
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriAndParameterUri
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
ByTemplateUriWithNoParameters
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ValidationLevel
Imposta il livello di convalida per convalida/simulazione. ValidationLevel può essere Template(Skips provider validation), Provider(Esegue la convalida completa) o ProviderNoRbac(Esegue la convalida completa usando controlli di lettura controllo degli accessi in base al ruolo anziché controlli di scrittura controllo degli accessi in base al ruolo per la convalida del provider).
Proprietà dei parametri
Tipo: String
Valore predefinito: None(Provider)
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Microsoft.Azure.Management.ResourceManager.Models.DeploymentMode
Output