Schnellstart: Erstellen und Verwalten von Workflows mit Azure PowerShell in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch)

In diesem Schnellstart wird gezeigt, wie sie automatisierte Workflows erstellen und verwalten, die in Azure Logic Apps ausgeführt werden, indem SieAzure PowerShell verwenden. In PowerShell können Sie eine Verbrauchslogik-App in mehrinstanzenfähigen Azure Logic Apps erstellen, indem Sie die JSON-Datei für eine Logik-App-Workflowdefinition verwenden. Anschließend können Sie Ihre Logik-App verwalten, indem Sie die Cmdlets im PowerShell-Modul Az.LogicApp ausführen.

Hinweis

Dieser Schnellstart gilt derzeit nur für Verwendungslogik-Logic-App-Workflows, die in Azure Logic Apps mit mehreren Mandanten ausgeführt werden. Azure PowerShell ist derzeit für Standardlogik-App-Workflows nicht verfügbar, die in einzelinstanzfähigen Azure Logic Apps ausgeführt werden. Weitere Informationen finden Sie unter Ressourcentyp und Unterschiede im Host der Azure Logic-Apps.

Wenn Sie neu bei Azure Logic Apps sind, erfahren Sie, wie Sie Ihren ersten Verbrauchs-Logik-App-Workflow über das Azure-Portal oder in Visual Studio Code erstellen.

Voraussetzungen

Überprüfung der Voraussetzungen

Überprüfen Sie Ihre Umgebung, bevor Sie beginnen:

  • Melden Sie sich beim Azure-Portal an, und führen Sie Connect-AzAccount aus, um sich zu vergewissern, dass Ihr Abonnement aktiv ist.

  • Überprüfen Sie Ihre Version von Azure PowerShell, indem Sie Get-InstalledModule -Name Az ausführen. Die neuesten Versionshinweise finden Sie unter aktuelle Versionshinweise.

    Wenn Sie nicht über die neueste Version verfügen, aktualisieren Sie Ihre Installation, indem Sie Aktualisieren des Azure PowerShell-Moduls befolgen.

Beispiel - Erstellen einer Ressourcengruppe

Sollten Sie noch nicht über eine Ressourcengruppe für Ihre Logik-App verfügen, erstellen Sie die Gruppe mithilfe des Cmdlets New-AzResourceGroup. Mit dem folgenden Befehl wird beispielsweise eine Ressourcengruppe namens testResourceGroup am Standort westus erstellt:

New-AzResourceGroup -Name testResourceGroup -Location westus

In der Ausgabe wird ProvisioningState als Succeeded angezeigt, wenn Ihre Ressourcengruppe erfolgreich erstellt wurde:

ResourceGroupName : testResourceGroup
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/testResourceGroup

Workflow-Definition

Zum Erstellen einer neuen Logik-App oder zum Aktualisieren einer vorhandenen Logik-App mittels Azure PowerShell benötigen Sie eine Workflowdefinition für Ihre Logik-App. Um eine Beispiel-Workflow-Definition anzuzeigen, öffnen Sie im Azure-Portal einen beliebigen vorhandenen Logik-App-Workflow im Designer. Wählen Sie auf der Designer-Symbolleiste die Option Codeansicht aus, die die dem Workflow zugrunde liegende Definition im JSON-Format anzeigt.

Beim Ausführen der Befehle zum Erstellen oder Aktualisieren Ihrer Logik-App wird Ihre Workflowdefinition als erforderlicher Parameter hochgeladen (Definition oder DefinitionFilePath), je nach festgelegtem Parameter. Die Workflowdefinition muss als JSON-Datei erstellt werden, die dem Schema der Workflowdefinitionssprache entspricht.

Erstellen von Logik-Apps mit PowerShell

Für die Erstellung eines Logik-App-Workflows über Azure PowerShell können Sie das cmdlet New-AzLogicApp mit einer JSON-Datei für die Definition verwenden.

Beispiel - Erstellen einer Logik-App

In diesem Beispiel wird ein Workflow namens testLogicApp in der Ressourcengruppe testResourceGroup am Standort westus erstellt. Die JSON-Datei testDefinition.json enthält die Workflowdefinition.

New-AzLogicApp -ResourceGroupName testResourceGroup -Location westus -Name testLogicApp -DefinitionFilePath .\testDefinition.json

Wenn Ihr Workflow erfolgreich erstellt wurde, zeigt PowerShell Ihre neue Workflowdefinition an.

Aktualisieren von Logik-Apps mit PowerShell

Um den Workflow einer Logik-App über Azure PowerShell zu aktualisieren, verwenden Sie das Cmdlet Set-AzLogicApp.

Beispiel - Aktualisieren einer Logik-App

Dieses Beispiel zeigt, wie Sie den im vorherigen Abschnitt erstellte Beispielworkflow mithilfe einer anderen JSON-Definitionsdatei, newTestDefinition.json, aktualisieren.

Set-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp -DefinitionFilePath .\newTestDefinition.json

Wenn Ihr Workflow erfolgreich aktualisiert wurde, wird von PowerShell die aktualisierte Workflowdefinition Ihrer Logik-App angezeigt.

Löschen von Logik-Apps mit PowerShell

Um den Workflow einer Logik-App über Azure PowerShell zu löschen, verwenden Sie das Cmdlet Remove-AzLogicApp.

Beispiel - Löschen einer Logik-App

In diesem Beispiel wird der in einem vorherigen Abschnitt erstellte Beispielworkflow gelöscht.

Remove-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Nachdem Sie auf die Bestätigungsaufforderung mit y reagiert haben, wird die Logik-App gelöscht.

Überlegungen - Löschen einer Logik-App

Das Löschen einer Logik-App wirkt sich wie folgt auf Workflow-Instanzen aus:

  • Azure Logic Apps unternimmt den besten Versuch, um alle laufenden und anstehenden Läufe abzusagen.

    Selbst bei einem großen Volumen oder einem umfangreichen Backlog werden die meisten Durchläufe abgesagt, bevor sie abgeschlossen oder gestartet werden. Es kann jedoch einige Zeit dauern, bis der Abbruchvorgang abgeschlossen ist. In der Zwischenzeit werden möglicherweise einige Ausführungen gestartet, während die Runtime den Abbruchprozess durchläuft.

  • Azure Logic Apps erstellt oder führt keine neuen Workflowinstanzen aus.

  • Wenn Sie einen Workflow löschen und dann denselben Workflow neu erstellen, verfügt der neu erstellte Workflow nicht über dieselben Metadaten wie der gelöschte Workflow. Sie müssen jeden Workflow, der den gelöschten Workflow aufgerufen hat, neu speichern. Auf diese Weise ruft der Aufrufer die richtigen Informationen für den neu erstellten Workflow ab. Andernfalls schlagen Aufrufe des neu erstellten Workflows mit einem Unauthorized-Fehler fehl. Dieses Verhalten gilt auch für Workflows, die Artefakte in Integrationskonten und Workflows verwenden, welche Azure-Funktionen aufrufen.

Anzeigen von Logik-Apps in PowerShell

Ein bestimmter Logik-App-Workflow kann mithilfe des Befehls Get-AzLogicApp abgerufen werden.

Beispiel - Abrufen einer Logik-App

In diesem Beispiel wird die Logik-App testLogicApp in der Ressourcengruppe testResourceGroup zurückgegeben.

Get-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Verwandte Inhalte

  • Last updated on