Azure Automation-Runbooktypen

Einschränkungen

• Für die PowerShell 7.2-Runtimeversion werden die Modulaktivitäten nicht für die importierten Module extrahiert. Verwenden Sie die Azure Automation-Erweiterung für VS-Code, um die Erstellung von Runbooks zu vereinfachen.
• PowerShell 7.x unterstützt keine Workflows. Weitere Informationen finden Sie im PowerShell-Workflow für weitere Details.
• PowerShell 7.x unterstützt derzeit keine signierten Runbooks.
• Die Integration der Quellcodeverwaltung unterstützt PowerShell 7.2 nicht. Außerdem werden PowerShell 7.2-Runbooks in der Quellcodeverwaltung im Automation-Konto als Runtime 5.1 erstellt.
• Az-Modul 8.3.0 ist standardmäßig installiert. Die vollständige Liste der Komponentenmodule der ausgewählten Az-Modulversion wird angezeigt, sobald die Az-Version erneut mithilfe des Azure-Portals oder der API konfiguriert ist.
• Das importierte PowerShell 7.2-Modul würde während der Auftragsausführung überprüft. Stellen Sie sicher, dass alle Abhängigkeiten für das ausgewählte Modul für eine erfolgreiche Auftragsausführung ebenfalls importiert werden.
• Das Azure-Runbook unterstützt Start-Job mit -credential nicht.
• Azure unterstützt nicht alle PowerShell-Eingabeparameter. Weitere Informationen

Bekannte Probleme

• Runbooks, die von internen Dateipfaden abhängig sind, z. B. C:\modules, können aufgrund von Änderungen in der Dienst-Back-End-Infrastruktur fehlschlagen. Ändern Sie den Runbook-Code, um sicherzustellen, dass keine Abhängigkeiten von internen Dateipfaden vorhanden sind, und verwenden Sie Get-ChildItem, um die erforderlichen Modulinformationen abzurufen.

• Das Get-AzStorageAccount-Cmdlet kann aufgrund eines Fehlers fehlschlagen: Der Get-AzStorageAccount-Befehl wurde im Modul Az.Storage gefunden, aber das Modul konnte nicht geladen werden.

• Das Ausführen von untergeordneten Skripts mithilfe von .\child-runbook.ps1 wird nicht unterstützt.
  Alternative Lösung: Verwenden Sie Start-AutomationRunbook (internes Cmdlet) oder Start-AzAutomationRunbook (aus dem Modul Az.Automation), um ein weiteres Runbook aus dem übergeordneten Runbook zu starten.

• Wenn Sie das ExchangeOnlineManagement Modul in der Version 3.0.0 oder höher verwenden, können Fehler auftreten. Um das Problem zu beheben, stellen Sie sicher, dass Sie die PowerShellGet- und PackageManagement-Module explizit hochladen.

• Wenn Sie das New-AzAutomationVariable-Cmdlet in Az.Automation-Modul verwenden, um eine Variable vom Typ Objekt hochzuladen, funktioniert der Vorgang nicht wie erwartet.

  Problemumgehung: Konvertieren Sie das Objekt mithilfe des Cmdlets ConvertTo-Json in eine JSON-Zeichenfolge, und laden Sie dann die Variable mit der JSON-Zeichenfolge als Wert hoch. Diese Problemumgehung stellt sicher, dass die Variable innerhalb der Azure Automation-Umgebung ordnungsgemäß als JSON-Zeichenfolge behandelt wird.

  Beispiel: Erstellen eines PowerShell-Objekts, auf dem Informationen zu Azure-VMs gespeichert sind

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Einschränkungen

• Können keine parallele Verarbeitung zum gleichzeitigen Ausführen mehrerer Aktionen nutzen
• Können keine Prüfpunkte zum Fortsetzen des Runbooks bei einem Fehler nutzen
• Sie können nur PowerShell-, PowerShell-Workflow- und grafische Runbooks mithilfe des Cmdlets Start-AzAutomationRunbook als untergeordnete Runbooks einfügen, wobei ein neuer Auftrag erstellt wird.
• Für Runbooks kann die PowerShell-Anweisung #Requires nicht verwendet werden. Sie wird in der Azure-Sandbox und für Hybrid Runbook Workers nicht unterstützt und führt möglicherweise dazu, dass für den Auftrag ein Fehler auftritt.
• Das Azure-Runbook unterstützt Start-Job mit -credential nicht.
• Azure unterstützt nicht alle PowerShell-Eingabeparameter. Weitere Informationen

Bekannte Probleme

• Runbooks, die von internen Dateipfaden abhängig sind, z. B. C:\modules, können aufgrund von Änderungen in der Dienst-Back-End-Infrastruktur fehlschlagen. Ändern Sie den Runbook-Code, um sicherzustellen, dass keine Abhängigkeiten von internen Dateipfaden vorhanden sind, und verwenden Sie Get-ChildItem, um die erforderlichen Modulinformationen abzurufen.

  Beispielskript

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Das Get-AzStorageAccount-Cmdlet kann aufgrund eines Fehlers fehlschlagen: Der Get-AzStorageAccount-Befehl wurde im Modul Az.Storage gefunden, aber das Modul konnte nicht geladen werden.

• PowerShell-Runbooks können keine unverschlüsselten Variablenobjekte mit einem NULL-Wert abrufen.

• PowerShell-Runbooks können kein Variablenobjekt abrufen, dessen Name *~* enthält.

• Der Vorgang Get-Process in einer Schleife in einem PowerShell-Runbook kann nach etwa 80 Iterationen zum Absturz führen.

• Ein PowerShell-Runbook kann einen Fehler verursachen, wenn es versucht, eine große Datenmenge auf einmal in den Ausgabestream zu schreiben. Sie können dieses Problem in der Regel vermeiden, indem Sie nur die für die Arbeit mit großen Objekten benötigten Informationen in die Runbookausgabe einfügen. Anstatt Get-Process ohne Einschränkungen zu verwenden, können Sie z. B. nur die erforderlichen Parameter in die Cmdlet-Ausgabe einfügen wie bei Get-Process | Select ProcessName, CPU.

• Wenn Sie das ExchangeOnlineManagement-Modul in der Version 3.0.0 oder höher verwenden, können Fehler auftreten. Um das Problem zu beheben, stellen Sie sicher, dass Sie auch die PowerShellGet- und PackageManagement-Module explizit hochladen.

• Wenn Sie das Modul Az.Accounts mit Version 2.12.3 oder höher importieren, stellen Sie sicher, dass Sie das Newtonsoft.Json v10-Modul explizit importieren, wenn PowerShell 5.1-Runbooks von dieser Version des Moduls abhängig sind. Die Problemumgehung für dieses Problem besteht darin, PowerShell 7.2-Runbooks zu verwenden.

• Wenn Sie das New-AzAutomationVariable-Cmdlet in Az.Automation-Modul verwenden, um eine Variable vom Typ Objekt hochzuladen, funktioniert der Vorgang nicht wie erwartet.

  Problemumgehung: Konvertieren Sie das Objekt mithilfe des Cmdlets ConvertTo-Json in eine JSON-Zeichenfolge, und laden Sie dann die Variable mit der JSON-Zeichenfolge als Wert hoch. Diese Problemumgehung stellt sicher, dass die Variable innerhalb der Azure Automation-Umgebung ordnungsgemäß als JSON-Zeichenfolge behandelt wird.

  Beispiel: Erstellen eines PowerShell-Objekts, auf dem Informationen zu Azure-VMs gespeichert sind

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Einschränkungen

• PowerShell 7.1 wird von PowerShell im übergeordneten Produkt nicht mehr unterstützt. Es wird empfohlen, neue Runbooks für langfristigen Support in PowerShell 7.2 zu erstellen und die veralteten Runbooks zu aktualisieren.
• Die internen PowerShell-Cmdlets von Azure Automation werden auf einem Linux Hybrid Runbook Worker nicht unterstützt. Sie müssen das „automationassets“-Modul zu Beginn Ihres PowerShell-Runbooks importieren, um auf die Funktionen für freigegebene Ressourcen (Objekte) des Automation-Kontos zugreifen zu können.
• Für die PowerShell 7-Runtimeversion werden die Modulaktivitäten nicht für die importierten Module extrahiert.
• Der PSCredential-Runbookparametertyp wird in der PowerShell 7-Runtimeversion nicht unterstützt.
• PowerShell 7.x unterstützt keine Workflows. Weitere Informationen finden Sie unter PowerShell-Workflow für weitere Details.
• PowerShell 7.x unterstützt derzeit keine signierten Runbooks.
• Die Quellcodeverwaltungsintegration unterstützt PowerShell 7.1 (Vorschau) nicht. Außerdem werden PowerShell 7.1 (Vorschau)-Runbooks in der Quellcodeverwaltung im Automation-Konto als Runtime 5.1 erstellt.
• Die Verwaltung des PowerShell 7.1-Moduls über „Get-AzAutomationModule“-Cmdlets wird nicht unterstützt.
• Das Runbook schlägt ohne Protokollablaufverfolgung fehl, wenn der Eingabewert das Zeichen ‘ enthält.
• Das Azure-Runbook unterstützt Start-Job mit -credential nicht.
• Azure unterstützt nicht alle PowerShell-Eingabeparameter. Weitere Informationen

Bekannte Probleme

• Runbooks, die von internen Dateipfaden abhängig sind, z. B. C:\modules, können aufgrund von Änderungen in der Dienst-Back-End-Infrastruktur fehlschlagen. Ändern Sie den Runbook-Code, um sicherzustellen, dass keine Abhängigkeiten von internen Dateipfaden vorhanden sind, und verwenden Sie Get-ChildItem, um die erforderlichen Modulinformationen abzurufen.

  Beispielskript

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Das Get-AzStorageAccount-Cmdlet kann aufgrund eines Fehlers fehlschlagen: Der Get-AzStorageAccount-Befehl wurde im Modul Az.Storage gefunden, aber das Modul konnte nicht geladen werden.

• Das Ausführen von untergeordneten Skripts mithilfe von .\child-runbook.ps1 wird in dieser Vorschauversion nicht unterstützt. Problemumgehung: Verwenden Sie Start-AutomationRunbook (internes Cmdlet) oder Start-AzAutomationRunbook (aus dem Az.Automation-Modul), um ein weiteres Runbook aus dem übergeordneten Runbook zu starten.

• Runbookeigenschaften, die die Protokollierungsvoreinstellung definieren, werden in der PowerShell 7-Runtime nicht unterstützt. Problemumgehung: Legen Sie die Einstellung explizit am Anfang des Runbook wie folgt fest:

      $VerbosePreference = "Continue"
  
      $ProgressPreference = "Continue"
  

• Vermeiden Sie den Import des Moduls Az.Accounts in Version 2.4.0 für die PowerShell 7-Runtime, da es zu unerwartetem Verhalten bei Verwendung dieser Version in Azure Automation führen kann.

• Möglicherweise treten Formatierungsprobleme mit Fehlerausgabestreams für den Auftrag auf, der in der PowerShell 7-Runtime ausgeführt wird.

• Wenn Sie ein PowerShell 7.1-Modul importieren, das von anderen Modulen abhängig ist, können Sie feststellen, dass die Importschaltfläche auch dann grau ist, wenn PowerShell 7.1 Version des abhängigen Moduls installiert ist. Beispielsweise weist das Modul „Az PowerShell-Modul.Compute“ in der Version 4.20.0 eine Abhängigkeit vom Modul „Az.Accounts“ auf, nämlich dass > = Version 2.6.0 ist. Dieses Problem tritt auf, wenn ein entsprechendes abhängiges Modul in PowerShell 5.1 die Versionsanforderungen nicht erfüllt. Die Version 5.1 des Moduls „Az.Accounts“ war beispielsweise < Version 2.6.0.

• Wenn Sie das PowerShell 7-Runbook mithilfe des Webhooks starten, wird der Webhookeingabeparameter automatisch in einen ungültigen JSON-Code konvertiert.

• Es wird empfohlen, die ExchangeOnlineManagement-Modulversion 3.0.0 oder niedriger zu verwenden, da Version 3.0.0 oder höher zu Auftragsfehlern führen kann.

• Wenn Sie das Modul Az.Accounts mit Version 2.12.3 oder höher importieren, stellen Sie sicher, dass Sie das Newtonsoft.Json v10-Modul explizit importieren, wenn PowerShell 7.1-Runbooks von dieser Version des Moduls abhängig sind. Die Problemumgehung für dieses Problem besteht darin, PowerShell 7.2-Runbooks zu verwenden.

• Wenn Sie das New-AzAutomationVariable-Cmdlet in Az.Automation-Modul verwenden, um eine Variable vom Typ Objekt hochzuladen, funktioniert der Vorgang nicht wie erwartet.

  Problemumgehung: Konvertieren Sie das Objekt mithilfe des Cmdlets ConvertTo-Json in eine JSON-Zeichenfolge, und laden Sie dann die Variable mit der JSON-Zeichenfolge als Wert hoch. Diese Problemumgehung stellt sicher, dass die Variable innerhalb der Azure Automation-Umgebung ordnungsgemäß als JSON-Zeichenfolge behandelt wird.

  Beispiel: Erstellen eines PowerShell-Objekts, auf dem Informationen zu Azure-VMs gespeichert sind

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

• Für Python 3.10 (Vorschau)-Module werden derzeit nur die Wheel-Dateien für das cp310 Linux-Betriebssystem unterstützt. Weitere Informationen
• Die Integration der Quellcodeverwaltung wird nicht unterstützt.
• Benutzerdefinierte Pakete für Python 3.10 (Vorschau) werden nur während der Auftragsruntime überprüft. Es wird erwartet, dass der Auftrag fehlschlägt, wenn das Paket in der Runtime nicht kompatibel ist oder wenn erforderliche Abhängigkeiten von Paketen nicht in das Automation-Konto importiert wurden.
• Derzeit werden Python 3.10 (Vorschau)-Runbooks nur im Azure-Portal unterstützt. REST-API und PowerShell werden nicht unterstützt.

• Erfordern Kenntnisse mit Python-Skripts
• Die Integration der Quellcodeverwaltung wird nicht unterstützt.
• Verwenden Sie für Python 3.8-Module Wheel-Dateien für cp38-amd64.
• Erfordern für die Verwendung von Bibliotheken von Drittanbietern das Importieren der Pakete in das Automation-Konto
• Das Verwenden des Cmdlets Start-AutomationRunbook in PowerShell oder einem PowerShell-Workflow zum Starten eines Python 3.8-Runbooks funktioniert nicht. Sie können das Cmdlet Start-AzAutomationRunbook aus dem Modul Az.Automation oder das Cmdlet Start-AzureRmAutomationRunbook aus dem Modul AzureRm.Automation verwenden, um diese Einschränkung zu umgehen. 
• Azure Automation unterstützt sys.stderr nicht.
• Da das Python-Paket automationassets auf pypi.org nicht verfügbar ist, kann es nicht auf einen Windows-Computer importiert werden.

• Python 2.7 wird von Python im übergeordneten Produkt nicht mehr unterstützt. Es wird empfohlen, neue Runbooks in den unterstützten Versionen zu erstellen und die veralteten Runbooks zu aktualisieren.
• Erfordern Kenntnisse mit Python-Skripts
• Verwenden Sie für Python 2.7.12-Module Wheel-Dateien für cp27-amd6.
• Erfordern für die Verwendung von Bibliotheken von Drittanbietern das Importieren der Pakete in das Automation-Konto
• Azure Automation unterstützt sys.stderr nicht.
• Da das Python-Paket automationassets auf pypi.org nicht verfügbar ist, kann es nicht auf einen Windows-Computer importiert werden.