AzureResourceGroupDeployment@1 – Azure Resource Group Deployment v1 task

Artikel
2025-03-24

Verwenden Sie diese Aufgabe, um Azure-Ressourcengruppen bereitzustellen, zu starten, zu beenden und zu löschen.

Diese Aufgabe ist veraltet; verwenden Sie AzureResourceGroupDeployment@2.

Syntax

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Eingänge

ConnectedServiceNameSelector - Azure-Verbindungstyp
string. Zulässige Werte: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure Classic). Standardwert: ConnectedServiceName.

Erforderlich. Wählt die Dienstverbindung aus, die ein Azure-Abonnement für die Bereitstellung enthält.

ConnectedServiceName - Azure-Abonnement-
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Erforderlich. Wählt die Dienstverbindung aus, die ein Azure-Abonnement für die Bereitstellung enthält.

ConnectedServiceNameClassic - azure Classic-Abonnement
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Wählt ein Azure Classic-Abonnement für die Bereitstellung aus.

action - Aktion
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName. Zulässige Werte: Create Or Update Resource Group, Select Resource Group, Start (Virtuelle Computer starten), Stop (Virtuelle Computer beenden), Restart (virtuelle Computer neu starten), Delete (virtuelle Computer löschen), DeleteRG (Ressourcengruppe löschen). Standardwert: Create Or Update Resource Group.

Die Aktion, die für die Azure-Ressourcen oder -Ressourcengruppe ausgeführt werden soll.

actionClassic - Aktion
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameClassic. Zulässige Werte: Select Resource Group (Clouddienst auswählen). Standardwert: Select Resource Group.

Die Aktion, die für die Azure-Ressourcen oder den Clouddienst ausgeführt werden soll.

resourceGroupName - Ressourcengruppe
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Stellt den Namen der Ressourcengruppe bereit.

cloudService - CloudDienst-
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Stellt den Namen des Clouddiensts bereit.

location -
string. Erforderlich, wenn action = Create Or Update Resource Group. Zulässige Werte: Australia East, Australia Southeast, Brazil South, Canada Central, Canada East, Central India, Central US, East Asia, East US, East US 2 , Japan East, Japan West, North Central US, North Europe, South Central US, South India, Southeast Asia, UK South, UK West, West Central US, West Europe, West India, West US, West US 2. Standardwert: East US.

Der Speicherort, an dem die Ressourcengruppe bereitgestellt werden soll. Wenn die Ressourcengruppe bereits im Abonnement vorhanden ist, wird dieser Wert ignoriert.

csmFile - Vorlage
string. Erforderlich, wenn action = Create Or Update Resource Group.

Gibt den Pfad oder ein Muster an, das auf die Azure Resource Manager-Vorlage verweist. Erfahren Sie mehr über Azure Resource Manager-Vorlagen. Um sofort zu beginnen, verwenden Sie dieser Beispielvorlage.

csmParametersFile - Vorlagenparameter
string. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group.

Gibt die URL der Parameterdatei an. Beispiel-URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Um eine datei zu verwenden, die in einem privaten Speicherkonto gespeichert ist, rufen Sie das SAS-Token (Shared Access Signature) in die URL der Vorlage ab, und fügen Sie es ein. Beispiel: <blob_storage_url>/template.json?<SAStoken> Um eine Parameterdatei in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, verwenden Sie die Azure-Dateikopie Aufgabe, oder führen Sie die Schritte mit PowerShell oder Azure CLIaus.

Wenn Sie die Vorlagenparameter in einem Raster anzeigen möchten, klicken Sie auf … neben dem Textfeld "Vorlagenparameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an der Quelle aktiviert sind. Wenn sich Vorlagen im Azure Storage-Blob befinden, lesen Sie cross-Origin Resource Sharing, um CORS zu aktivieren.

overrideParameters - Außerkraftsetzen von Vorlagenparametern
string. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group.

Gibt die zu überschreibenden Vorlagenparameter an.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie auf ... neben dem Textfeld "Parameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an der Quelle aktiviert sind. Wenn sich die Vorlagen im Azure Storage-BLOB befinden, verweisen Sie auf diese Zeichenfolge, um CORS zu aktivieren, oder geben Sie die Vorlagenparameter ein, die im Textfeld außer Kraft gesetzt werden sollen.

Beispiel: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Wenn der Parameterwert mehrere Wörter enthält, schließen Sie die Wörter in Anführungszeichen ein, auch wenn Sie den Wert mithilfe von Variablen übergeben. Beispiel: -name "parameter value" -name2 "$(var)". Verwenden Sie zum Überschreiben von Objekttypparametern zeichenfolgenbasierte JSON-Objekte. Beispiel: -options ["option1"] -map {"key1": "value1" }.

deploymentMode - Bereitstellungsmodus
string. Erforderlich, wenn action = Create Or Update Resource Group. Zulässige Werte: Validation (Nur Gültigkeitsprüfung), Incremental, Complete. Standardwert: Incremental.

Der Incremental Modus behandelt Bereitstellungen als inkrementelle Aktualisierungen der Ressourcengruppe. Sie belässt unveränderte Ressourcen, die in der Ressourcengruppe vorhanden sind, aber nicht in der Vorlage angegeben sind.

Complete Modus löscht Ressourcen, die sich nicht in Ihrer Vorlage befinden. Der vollständige Modus dauert relativ viel Zeit als der inkrementelle Modus. Wenn das Zeitlimit für den Vorgang zunimmt, sollten Sie das Timeout erhöhen oder in den Incremental Modus wechseln.

Warnung

Der vollständige Modus löscht alle vorhandenen Ressourcen in der Ressourcengruppe, die nicht in der Vorlage angegeben sind. Überprüfen Sie, ob die Von Ihnen bereitgestellte Ressourcengruppe keine erforderlichen Ressourcen enthält, die nicht in der Vorlage angegeben sind.

mit Validate Modus können Sie Probleme mit der Vorlage finden, bevor Sie tatsächliche Ressourcen erstellen.

Hinweis

Der modus Validate erstellt immer eine Ressourcengruppe, auch wenn keine Ressourcen bereitgestellt werden.

Erfahren Sie mehr über Bereitstellungsmodi.

enableDeploymentPrerequisitesForCreate - Bereitstellungsvoraussetzungen aktivieren
boolean. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group. Standardwert: false.

Gilt nur, wenn die Ressourcengruppe virtuelle Computer enthält.

Wenn Sie die Option "Bereitstellungsgruppe" auswählen, wird der Bereitstellungsgruppen-Agent auf jedem virtuellen Computer konfiguriert.

Wenn Sie die WinRM-Option auswählen, wird der Windows Remote Management (WinRM)-Listener über DAS HTTPS-Protokoll auf Port 5986 mithilfe eines selbstsignierten Zertifikats konfiguriert. Diese Konfiguration ist für die Durchführung des Bereitstellungsvorgangs auf Azure-Computern erforderlich. Wenn die virtuellen Zielcomputer durch einen Lastenausgleich gesichert werden, stellen Sie sicher, dass die NAT-Regeln für den Zielport konfiguriert sind (5986).

enableDeploymentPrerequisitesForSelect - Bereitstellungsvoraussetzungen aktivieren
boolean. Wahlfrei. Wird verwendet, wenn action = Select Resource Group. Standardwert: false.

Gilt nur, wenn die Ressourcengruppe virtuelle Computer enthält.

Wenn Sie die Option "Bereitstellungsgruppe" auswählen, wird der Bereitstellungsgruppen-Agent auf jedem virtuellen Computer konfiguriert.

outputVariable - Ressourcengruppe
string.

Erforderlich, wenn eine vorhandene Ressourcengruppe ausgewählt ist. Stellt einen Namen für die Ressourcengruppenvariable bereit. Die Variable kann als $(variableName) verwendet werden, um in nachfolgenden Vorgängen auf die Ressourcengruppe zu verweisen, z. B. in PowerShell auf Zielcomputern für die Bereitstellung von Anwendungen.

Nur gültig, wenn die ausgewählte Aktion Create, Updateoder Selectist.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: azureps:
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.103.0 oder höher
Vorgangskategorie	Einsetzen

Freigeben über