AzureResourceGroupDeployment@1: Azure-Ressourcengruppenbereitstellung v1-Aufgabe

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

Diese Aufgabe ist veraltet. AzureResourceGroupDeployment@2 verwenden.

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.

Eingaben

ConnectedServiceNameSelector - Azure-Verbindungstyp
string. Zulässige Werte: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (klassisch). 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 - Klassisches Azure-Abonnement
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameClassic.

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

action - Aktion
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName. Zulässige Werte: Create Or Update Resource Group, StartSelect Resource Group, (Start Virtual Machines), Stop (Stop Virtual Machines), Restart (Restart Virtual Machines), Delete (Delete Virtual Machines), DeleteRG (Delete Resource Group). 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 (Wählen Sie Clouddienst aus. 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.

Gibt den Namen der Ressourcengruppe an.

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

Gibt den Namen des Clouddiensts an.

location - Lage
string. Erforderlich, wenn action = Create Or Update Resource Group. Zulässige Werte: Australia East, Australia Southeast, Brazil South, Canada EastCanada Central, Central IndiaEast USEast AsiaCentral USJapan WestNorth Central USEast US 2 Japan East, , , . North EuropeSouth Central USSouth IndiaSoutheast AsiaUK SouthUK WestWest Central USWest EuropeWest IndiaWest USWest 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. Verwenden Sie diese Beispielvorlage, um sofort loszulegen.

csmParametersFile - Vorlagenparameter
string. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group.

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

Um eine in einem privaten Speicherkonto gespeicherte Datei zu verwenden, rufen Sie das SAS-Token (Shared Access Signature) ab und fügen es in die URL der Vorlage 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-Dateikopieraufgabe , oder führen Sie die Schritte mithilfe von PowerShell oder der Azure CLI aus.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie auf … neben dem Textfeld Vorlagenparameter außer Kraft setzen. Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich Vorlagen im Azure Storage-Blob befinden, finden Sie informationen zum Aktivieren von CORS unter Cross-Origin Resource Sharing( Cross-Origin Resource Sharing ).

overrideParameters - Überschreiben von Vorlagenparametern
string. Optional. Verwenden Sie , 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. Diese Funktion erfordert, dass CORS-Regeln in 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 überschrieben 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 zeichenfolgenisierte JSON-Objekte, um Objekttypparameter zu überschreiben. Beispiel: -options ["option1"] -map {"key1": "value1" }.

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

Der Incremental Modus behandelt Bereitstellungen als inkrementelle Updates für die Ressourcengruppe. Ressourcen, die in der Ressourcengruppe vorhanden, aber nicht in der Vorlage angegeben sind, bleiben unverändert.

Der Complete-Modus löscht Ressourcen, die sich nicht in Ihrer Vorlage befinden. Der vollständige Modus nimmt relativ mehr Zeit in Anspruch als der inkrementelle Modus. Wenn für die Aufgabe ein Timeout auftritt, sollten Sie das Timeout erhöhen oder in den Incremental Modus wechseln.

Warnung

Im Vollständigen Modus werden alle vorhandenen Ressourcen in der Ressourcengruppe gelöscht, die nicht in der Vorlage angegeben sind. Überprüfen Sie, ob die Ressourcengruppe, für die Sie die Bereitstellung durchführen, keine erforderlichen Ressourcen enthält, die nicht in der Vorlage angegeben sind.

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

Hinweis

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

Erfahren Sie mehr über Bereitstellungsmodi.

enableDeploymentPrerequisitesForCreate - Voraussetzungen für die Bereitstellung aktivieren
boolean. Optional. Verwenden Sie , 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 Option WinRM auswählen, wird der Windows Remote Management(WinRM)-Listener über das HTTPS-Protokoll an Port 5986 mithilfe eines selbstsignierten Zertifikats konfiguriert. Diese Konfiguration ist für die Ausführung von Bereitstellungsvorgängen auf Azure-Computern erforderlich. Wenn die virtuellen Zielcomputer von einem Lastenausgleich unterstützt werden, stellen Sie sicher, dass die NAT-Regeln für eingehenden Datenverkehr für den Zielport (5986) konfiguriert sind.

enableDeploymentPrerequisitesForSelect - Voraussetzungen für die Bereitstellung aktivieren
boolean. Optional. Verwenden Sie , 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.

Wenn Sie die Option WinRM auswählen, wird der Windows Remote Management(WinRM)-Listener über das HTTPS-Protokoll an Port 5986 mithilfe eines selbstsignierten Zertifikats konfiguriert. Diese Konfiguration ist für die Ausführung von Bereitstellungsvorgängen auf Azure-Computern erforderlich. Wenn die virtuellen Zielcomputer durch einen Lastenausgleich unterstützt werden, stellen Sie sicher, dass die NAT-Regeln für eingehenden Datenverkehr für den Zielport (5986) konfiguriert sind.

outputVariable - Ressourcengruppe
string.

Erforderlich, wenn eine vorhandene Ressourcengruppe ausgewählt wird. Stellt einen Namen für die Ressourcengruppenvariable bereit. Die Variable kann verwendet $(variableName) werden, um auf die Ressourcengruppe in nachfolgenden Aufgaben zu verweisen, z. B. im PowerShell-Task auf Zielcomputern zum Bereitstellen von Anwendungen.

Ist nur gültig, wenn die ausgewählte Aktion , Updateoder SelectistCreate.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: azureps
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	1.103.0 oder höher
Aufgabenkategorie	Bereitstellen