New-AzureRmDeployment

Syntax

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmDeployment fügt eine Bereitstellung im aktuellen Abonnementbereich hinzu. Dazu gehören die Ressourcen, die für die Bereitstellung erforderlich sind.

Eine Azure-Ressource ist eine vom Benutzer verwaltete Azure-Entität. Eine Ressource kann in einer Ressourcengruppe wie Datenbankserver, Datenbank, Website, virtueller Computer oder Speicherkonto leben. Oder es kann sich um eine Ressource auf Abonnementebene handeln, z. B. Rollendefinition, Richtliniendefinition usw.

Verwenden Sie zum Hinzufügen von Ressourcen zu einer Ressourcengruppe das New-AzureRmDeployment , das eine Bereitstellung in einer Ressourcengruppe erstellt. Das Cmdlet New-AzureRmDeployment erstellt eine Bereitstellung im aktuellen Abonnementbereich, die Ressourcen auf Abonnementebene bereitstellt.

Wenn Sie eine Bereitstellung im Abonnement hinzufügen möchten, geben Sie den Standort und eine Vorlage an. Der Speicherort teilt Azure Resource Manager mit, wo die Bereitstellungsdaten gespeichert werden sollen. Die Vorlage ist eine JSON-Zeichenfolge, die einzelne Ressourcen enthält, die bereitgestellt werden sollen. Die Vorlage enthält Parameterplatzhalter für erforderliche Ressourcen und konfigurierbare Eigenschaftswerte, z. B. Namen und Größen.

Wenn Sie eine benutzerdefinierte Vorlage für die Bereitstellung verwenden möchten, geben Sie den Parameter TemplateFile oder den TemplateUri-Parameter an. Jede Vorlage verfügt über Parameter für konfigurierbare Eigenschaften. Um Werte für die Vorlagenparameter anzugeben, geben Sie den Parameter TemplateParameterFile oder den TemplateParameterObject-Parameter an. Alternativ können Sie die Vorlagenparameter verwenden, die dem Befehl dynamisch hinzugefügt werden, wenn Sie eine Vorlage angeben. Um dynamische Parameter zu verwenden, geben Sie sie an der Eingabeaufforderung ein, oder geben Sie ein Minuszeichen (-) ein, um einen Parameter anzugeben und die TAB-TASTE zu verwenden, um die verfügbaren Parameter zu durchlaufen. Vorlagenparameterwerte, die Sie an der Eingabeaufforderung eingeben, haben Vorrang vor Werten in einem Vorlagenparameterobjekt oder einer Datei.

Beispiele

Beispiel 1: Verwenden einer benutzerdefinierten Vorlagen- und Parameterdatei zum Erstellen einer Bereitstellung

PS C:\>New-AzureRmDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -TemplateVersion "2.1"

Mit diesem Befehl wird eine neue Bereitstellung im aktuellen Abonnementbereich mithilfe einer benutzerdefinierten Vorlage und einer Vorlagendatei auf dem Datenträger erstellt. Der Befehl verwendet den TemplateFile-Parameter zum Angeben der Vorlage und den TemplateParameterFile-Parameter zum Angeben einer Datei, die Parameter und Parameterwerte enthält. Er verwendet den TemplateVersion-Parameter , um die Version der Vorlage anzugeben.

Parameter

-ApiVersion

-AsJob

-Confirm

-DefaultProfile

-DeploymentDebugLogLevel

-Location

-Name

-Pre

-TemplateFile

-TemplateParameterFile

-TemplateParameterObject

-TemplateParameterUri

-TemplateUri

-WhatIf

Eingaben

String

System.Collections.Hashtable

Ausgaben

PSDeployment