Aktualisierung der Azure PowerShell Module in der Automatisierung

Die am häufigsten verwendeten PowerShell-Module werden standardmäßig in jedem Automation-Konto bereitgestellt. Weitere Informationen finden Sie unter Standardmodule. Wenn das Azure-Team die Azure Module regelmäßig aktualisiert, können Änderungen mit den enthaltenen Cmdlets auftreten. Diese Änderungen, wie z. B. das Umbenennen eines Parameters oder das vollständige Entwerten eines Cmdlets, können möglicherweise negative Auswirkungen auf Ihre Runbooks haben.

Hinweis

Globale Module (also Module, die standardmäßig von Automation bereitgestellt werden) können nicht gelöscht werden.

Wichtig

Mit der neuen Laufzeitumgebung können Sie Module und Pakete verwalten, weil Sie die Auftragsausführungsumgebung konfigurieren können. In der neuen Benutzeroberfläche sind die Blades „Module“ und „Pakete“ nicht verfügbar. Informationen zum Verwalten von Modulen und Paketen finden Sie unter Verwalten der Laufzeitumgebung und zugehöriger Runbooks.

Einrichten eines Automation-Kontos

Führen Sie im Zuge von Aktualisierungen Tests und Überprüfungen durch, um Auswirkungen auf Ihre Runbooks und die damit automatisierten Prozesse zu vermeiden. Wenn Sie für diesen Zweck kein dediziertes Automation-Konto haben, sollten Sie eines erstellen, damit Sie während der Entwicklung Ihrer Runbooks viele verschiedene Szenarios testen können. Diese Tests sollten iterative Änderungen wie das Aktualisieren der PowerShell-Module einschließen.

Stellen Sie sicher, dass Ihrem Automation-Konto eine systemseitig zugewiesene verwaltete Identität oder eine benutzerseitig zugewiesene verwaltete Identität hinzugefügt wurde.

Wenn Sie Ihre Skripts lokal entwickeln, empfiehlt es sich, beim Testen lokal die gleichen Modulversionen zu verwenden wie in Ihrem Automation-Konto, um sicherzustellen, dass Sie die gleichen Ergebnisse erhalten. Nach dem Überprüfen der Ergebnisse und dem Anwenden aller erforderlichen Änderungen können Sie die Änderungen in die Produktion übernehmen.

Hinweis

Ein neues Automation-Konto enthält ggf. nicht die neuesten Module.

Az-Module aktualisieren

In den folgenden Abschnitten wird erläutert, wie Sie Az-Module entweder über das Portal (empfohlen) oder über das Runbook aktualisieren können.

Aktualisieren von Az-Modulen über das Portal

Derzeit ist die Aktualisierung von AZ-Modulen nur über das Portal möglich. Aktualisierungen über PowerShell und ARM-Vorlage werden in Zukunft verfügbar sein. Nur Standard-AZ-Module werden aktualisiert, wenn Sie die folgenden Schritte ausführen:

  1. Melden Sie sich beim portal Azure an, und navigieren Sie zu Ihrem Automatisierungskonto.

  2. Wählen Sie unter Freigegebene Ressourcen die Option Module aus.

  3. Klicken Sie auf Az-Module aktualisieren.

  4. Wählen Sie Modul zum Aktualisieren. Standardmäßig wird das Az-Modul angezeigt.

  5. Wählen Sie in der Dropdownliste Modulversion und Runtimeversion aus.

  6. Wählen Sie Aktualisieren, um das Az-Modul auf die von Ihnen gewählte Version zu aktualisieren. Auf der Seite Module können Sie die Liste wie unten dargestellt anzeigen:

    Aktualisierung der AZ-Modulseite mit Auswahlen.

Wenn Sie eine niedrigere Version als die im Automatisierungskonto importierte Version des Az-Moduls auswählen, führt der Aktualisierungsvorgang ein Rollback auf die ausgewählte niedrigere Version durch.

Sie können den Aktualisierungsvorgang überprüfen, indem Sie die Eigenschaften Modulversion und Status der aktualisierten Module überprüfen, die in der Liste der Module unter PowerShell-Module angezeigt werden.

Das Azure Team aktualisiert regelmäßig die Modulversion und bietet eine Möglichkeit, die default Az-Module zu aktualisieren, indem sie die Modulversion aus der Dropdownliste auswählen.

Aktualisieren von Az-Modulen über das Runbook

So aktualisieren Sie die Azure Module in Ihrem Automatisierungskonto:

  1. Verwenden Sie das Update-AutomationAzureModulesForAccount Runbook, das als Open Source verfügbar ist.
  2. Laden Sie aus dem GitHub Repository herunter, um mit der Verwendung dieses Runbooks zu beginnen, um Ihre Azure Module zu aktualisieren.
  3. Importieren Sie es in Ihr Automation-Konto, oder führen Sie es als Skript aus. Informationen zum Importieren eines Runbooks in Ihr Automation-Konto finden Sie unter Importieren eines Runbooks.

Hinweis

Wir empfehlen Ihnen, Az-Module über Azure Portal zu aktualisieren. Sie können diesen Schritt auch mithilfe des Skripts Update-AutomationAzureModulesForAccount ausführen, das als Open Source-Ressource verfügbar ist und als Referenz bereitgestellt wird. Falls jedoch ein Runbookfehler auftritt, müssen Sie Parameter im Runbook nach Bedarf ändern oder das Skript dem Szenario entsprechend debuggen.

Das Runbook Update-AutomationAzureModulesForAccount unterstützt standardmäßig das Aktualisieren der module Azure, AzureRM und Az. Weitere Informationen zum Aktualisieren von Az finden Sie im Update Azure Module runbook README. Automatisierungsmodule mit diesem Runbook ausführen. Es gibt weitere wichtige Faktoren, die Sie berücksichtigen müssen, wenn Sie die Az-Module in Ihrem Automatisierungskonto verwenden. Weitere Informationen finden Sie unter Manage-Module in Azure Automation.

Verwenden Sie den Runbook-Aktualisierungscode als reguläres PowerShell-Skript

Der Runbookcode kann als reguläres PowerShell-Skript verwendet werden (anstelle eines Runbooks). Melden Sie sich dazu zuerst mit dem Cmdlet Connect-AzAccount bei Azure an, und übergeben Sie dann -Login $false an das Skript.

Verwenden Sie das Aktualisierungsrunbook für die souveränen Clouds

Wenn Sie dieses Runbook für Sovereign Clouds verwenden möchten, übergeben Sie mithilfe des Parameters AzEnvironment die korrekte Umgebung an das Runbook. Zulässige Werte sind AzureCloud (Azure öffentliche Cloud), AzureChinaCloud, AzureGermanCloud und AzureUSGovernment. Diese Werte können mithilfe von Get-AzEnvironment | select Name abgerufen werden. Wenn Sie keinen Wert an dieses Cmdlet übergeben, wird das Runbook standardmäßig auf AzureCloud festgelegt.

Aktualisieren einer bestimmten Modulversion mithilfe des Aktualisierungsrunbooks

Wenn Sie eine bestimmte Azure PowerShell Modulversion anstelle des neuesten Moduls verwenden möchten, das auf dem PowerShell-Katalog verfügbar ist, übergeben Sie diese Versionen an den optionalen ModuleVersionOverrides-Parameter des Update-AutomationAzureModulesForAccount Runbook. Beispiele finden Sie im Runbook Update-AutomationAzureModulesForAccount.ps1. Azure PowerShell Module, die im Parameter ModuleVersionOverrides nicht erwähnt werden, werden mit den neuesten Modulversionen auf der PowerShell-Katalog aktualisiert. Wenn Sie nichts an den Parameter ModuleVersionOverrides übergeben, werden alle Module mit den neuesten Modulversionen auf dem PowerShell-Katalog aktualisiert. Dieses Verhalten ist für die Schaltfläche Update Azure Modules im Azure Portal identisch.

Nächste Schritte

  • Last updated on