Il cmdlet New-AzDeployment aggiunge una distribuzione nell'ambito della sottoscrizione corrente.
Sono incluse le risorse necessarie per la distribuzione.
Una risorsa di Azure è un'entità di Azure gestita dall'utente. Una risorsa può risiedere in un gruppo di risorse, ad esempio un server di database, un database, un sito Web, una macchina virtuale o un account di archiviazione.
In alternativa, può essere una risorsa a livello di sottoscrizione, ad esempio definizione del ruolo, definizione di criteri e così via.
Per aggiungere risorse a un gruppo di risorse, usare il New-AzResourceGroupDeployment che crea una distribuzione in un gruppo di risorse.
Il cmdlet New-AzDeployment crea una distribuzione nell'ambito della sottoscrizione corrente, che distribuisce le risorse a livello di sottoscrizione.
Per aggiungere una distribuzione in una sottoscrizione, specificare il percorso e un modello.
Il percorso indica ad Azure Resource Manager dove archiviare i dati di distribuzione. Il modello è una stringa JSON che contiene singole risorse da distribuire.
Il modello include segnaposto dei parametri per le risorse necessarie e valori di proprietà configurabili, ad esempio nomi e dimensioni.
Per usare un modello personalizzato per la distribuzione, specificare il parametro TemplateFile o 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
Questo comando crea una nuova distribuzione nell'ambito della sottoscrizione corrente usando un modello personalizzato e un file modello su disco, con il parametro tag definito.
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.
Esempio 2: Distribuire un modello archiviato in un account di archiviazione non pubblico usando un URI e un token di firma di accesso condiviso
Questo comando crea una nuova distribuzione usando il modello in TemplateUri che non è pubblico e richiede un parametro token per accedere a che verrebbe fornito usando il parametro QueryString.
L'esecuzione di questo comando accede effettivamente al modello usando l'URL https://example.com/example.json?foo.
Questa operazione può essere usata se si vuole usare un modello in un account di archiviazione specificando il token di firma di accesso condiviso come QueryString
Esempio 3: Usare un oggetto modello personalizzato e un file di parametri per creare una distribuzione
Questo comando crea una nuova distribuzione nell'ambito della sottoscrizione corrente usando un modello personalizzato e un file modello su disco convertito in una tabella hash in memoria.
I primi due comandi leggono il testo per il file modello su disco e lo converte in una tabella hash in memoria.
L'ultimo comando usa il parametro TemplateObject per specificare questa tabella hash e il parametro TemplateParameterFile per specificare un file contenente parametri e valori di parametro.
Esempio 4: Usare un file bicepparam per creare una distribuzione
Questo comando crea una nuova distribuzione nell'ambito della sottoscrizione corrente usando un file bicepparam su disco.
Il comando usa il parametro TemplateParameterFile per specificare un file con estensione bicepparam.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Name
Nome della distribuzione che verrà creato. Se non specificato, per impostazione predefinita viene impostato il nome del file modello quando viene fornito un file modello; il valore predefinito è l'ora corrente in cui viene fornito un oggetto modello, ad esempio "20131223140835".
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
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 -SkipTemplateParameterPrompt ignorerà questa richiesta e genererà un errore immediatamente se non è stato trovato un parametro da associare nel modello. Per gli script non interattivi, è possibile specificare -SkipTemplateParameterPrompt per fornire un messaggio di errore migliore nel caso in cui non siano soddisfatti tutti i parametri obbligatori.
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(Ignora la convalida del provider), Provider(Esegue la convalida completa) o ProviderNoRbac(Esegue la convalida completa utilizzando i controlli di lettura RBAC anziché i controlli di scrittura RBAC per la convalida del provider).
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-WhatIfExcludeChangeType
Tipi di modifica delle risorse delimitati da virgole da escludere dai risultati di simulazione. Applicabile quando è impostata l'opzione -WhatIf o -Confirm.
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.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.