New-AzureRmResourceGroupDeployment
Aggiunge una distribuzione di Azure a un gruppo di risorse.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-AzureRmResourceGroupDeployment aggiunge una distribuzione a un gruppo di risorse esistente. Sono incluse le risorse necessarie per la distribuzione. Una risorsa di Azure è un'entità di Azure gestita dall'utente, ad esempio un server di database, un database, un sito Web, una macchina virtuale o un account Archiviazione. Un gruppo di risorse di Azure è una raccolta di risorse di Azure distribuite come unità, ad esempio il sito Web, il server di database e i database necessari per un sito Web finanziario. Una distribuzione di un gruppo di risorse usa un modello per aggiungere risorse a un gruppo di risorse e le pubblica in modo che siano disponibili in Azure. Per aggiungere risorse a un gruppo di risorse senza usare un modello, usare il cmdlet New-AzureRmResource. Per aggiungere una distribuzione di un gruppo di risorse, specificare il nome di un gruppo di risorse esistente e un modello di gruppo di risorse. Un modello di gruppo di risorse è una stringa JSON che rappresenta un gruppo di risorse per un servizio complesso basato sul cloud, ad esempio un portale Web. Il modello include segnaposto dei parametri per le risorse necessarie e valori di proprietà configurabili, ad esempio nomi e dimensioni. È possibile trovare molti modelli nella raccolta di modelli di Azure oppure creare modelli personalizzati. È possibile usare il cmdlet Get-AzureRmResourceGroupGalleryTemplate per trovare un modello nella raccolta. Per usare un modello personalizzato per creare un gruppo di risorse, specificare il parametro TemplateFile o il parametro TemplateUri . Ogni modello ha parametri per le proprietà configurabili. Per specificare i valori per i parametri del modello, specificare il parametro TemplateParameterFile o il parametro TemplateParameterObject . In alternativa, è possibile usare i parametri del modello aggiunti dinamicamente al comando quando si specifica un modello. Per usare i parametri dinamici, digitarli al prompt dei comandi o digitare un segno meno (-) per indicare un parametro e usare il tasto TAB per scorrere i parametri disponibili. I valori dei parametri del modello immessi al prompt dei comandi hanno la precedenza sui valori in un oggetto parametro modello o in un file.
Esempio
Esempio 1: Usare un modello personalizzato e un file di parametri per creare una distribuzione
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Questo comando crea una nuova distribuzione usando un modello personalizzato e un file modello su disco. Il comando usa il parametro TemplateFile per specificare il modello e il parametro TemplateParameterFile per specificare un file che contiene parametri e valori di parametro.
Parametri
-ApiVersion
Specifica la versione dell'API supportata dal provider di risorse. È possibile specificare una versione diversa rispetto alla versione predefinita.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AsJob
Eseguire il cmdlet in background
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
| Tipo: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeploymentDebugLogLevel
Specifica un livello di log di debug. I valori validi per questo parametro sono:
- RequestContent
- ResponseContent
- Tutte le date
- None
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Force
Forza l'esecuzione del comando senza chiedere conferma all'utente.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Mode
Specifica la modalità di distribuzione. I valori validi per questo parametro sono:
- Completo
- Incremental In modalità completa, Resource Manager elimina le risorse esistenti nel gruppo di risorse ma non specificate nel modello. Nella modalità incrementale, Resource Manager lascia invariate le risorse esistenti nel gruppo di risorse che non sono specificate nel modello.
| Tipo: | DeploymentMode |
| Posizione: | Named |
| Valore predefinito: | Incremental |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specifica il nome della distribuzione del gruppo di risorse da creare.
| Tipo: | String |
| Alias: | DeploymentName |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Pre
Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ResourceGroupName
Specifica il nome del gruppo di risorse da distribuire.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-RollBackDeploymentName
Eseguire il rollback alla distribuzione con il nome specificato nel gruppo di risorse, non deve essere usato se si usa -RollbackToLastDeployment.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-RollbackToLastDeployment
Eseguire il rollback all'ultima distribuzione riuscita nel gruppo di risorse, non deve essere presente se viene usato -RollBackDeploymentName.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TemplateFile
Specifica il percorso completo di un file modello JSON. Può trattarsi di un modello personalizzato o di un modello di raccolta salvato come file JSON, ad esempio uno creato usando il cmdlet Save-AzureRmResourceGroupGalleryTemplate .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TemplateParameterFile
Specifica il percorso completo di un file JSON che contiene i nomi e i valori dei parametri del modello. Se un modello include parametri, è necessario specificare i valori dei parametri con il parametro TemplateParameterFile o il parametro TemplateParameterObject . I parametri del modello vengono aggiunti dinamicamente al comando quando si specifica un modello. Per usare i parametri dinamici, digitare un segno meno (-) per indicare un nome di parametro e quindi usare il tasto TAB per scorrere i parametri disponibili.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TemplateParameterObject
Specifica una tabella hash di nomi e valori dei parametri del modello.
Per informazioni sulle tabelle hash in Windows PowerShell, digitare Get-Help about_Hash_Tables.
Se un modello include parametri, è necessario specificare i valori dei parametri.
I parametri del modello vengono aggiunti dinamicamente al comando quando si specifica un modello.
| Tipo: | Hashtable |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TemplateParameterUri
Specifica l'URI di un file di parametri modello.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TemplateUri
Specifica l'URI di un file modello JSON. Questo file può essere un modello personalizzato o un modello di raccolta salvato come file JSON, ad esempio usando Save-AzureRmResourceGroupGalleryTemplate.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None
Output
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment