Typy elementów Runbook usługi Azure Automation

Ograniczenia

• Program PowerShell 7.4 jest dostępny tylko w środowisku środowiska uruchomieniowego.
• W przypadku wersji środowiska uruchomieniowego programu PowerShell 7.4 działania modułu nie są wyodrębniane dla zaimportowanych modułów. Użyj rozszerzenia Azure Automation dla programu VS Code, aby uprościć doświadczenie tworzenia runbooków.
• Program PowerShell 7.x nie obsługuje przepływów pracy. Aby uzyskać więcej informacji, zobacz Przepływ pracy programu PowerShell, aby uzyskać więcej szczegółów.
• Program PowerShell 7.x obecnie nie obsługuje podpisanych runbooków.
• Integracja kontroli źródła nie obsługuje programu PowerShell 7.4. Ponadto runbooki PowerShell 7.4 w ramach kontroli źródła są tworzone na koncie usługi Automation jako środowisko uruchomieniowe wersji 5.1.
• Moduł Az 12.3.0 jest instalowany domyślnie. Pełna lista modułów składowych wybranej wersji modułu Az jest wyświetlana po ponownym skonfigurowaniu wersji modułu Az przy użyciu portalu Azure lub interfejsu API.
• Zaimportowany moduł programu PowerShell 7.4 zostanie zweryfikowany podczas wykonywania zadania. Upewnij się, że wszystkie zależności dla wybranego modułu są również importowane do pomyślnego wykonania zadania.
• Runbook platformy Azure nie obsługuje Start-Job z -credential.
• Platforma Azure nie obsługuje wszystkich parametrów wejściowych programu PowerShell. Dowiedz się więcej.

Znane problemy

• Runbooki zależne od wewnętrznych ścieżek plików, takich jak C:\modules, mogą ulec awarii z powodu zmian w infrastrukturze zaplecza usługi. Zmień kod elementu Runbook, aby upewnić się, że nie ma zależności od ścieżek plików wewnętrznych i użyj polecenia Get-ChildItem , aby uzyskać wymagane informacje o module.

• Get-AzStorageAccountPolecenie cmdlet może zakończyć się niepowodzeniem z powodu błędu: Get-AzStorageAccount polecenie zostało znalezione w module Az.Storage, ale nie można załadować modułu.

• Wykonywanie skryptów dzieci przy użyciu .\child-runbook.ps1 nie jest obsługiwane.
  Obejście: użyj Start-AutomationRunbook (wewnętrznego polecenia cmdlet) lub Start-AzAutomationRunbook (z modułu Az.Automation), aby uruchomić inny Runbook z nadrzędnego Runbooka.

• W przypadku korzystania z modułu ExchangeOnlineManagement w wersji 3.0.0 lub nowszej można napotkać błędy. Aby rozwiązać ten problem, upewnij się, że jawnie załadujesz moduły PowerShellGet i PackageManagement.

• Jeśli używasz New-AzAutomationVariable polecenia cmdlet w module Az.Automation do przekazania zmiennej typu object, operacja nie działa zgodnie z oczekiwaniami. Obejście: Przekonwertuj obiekt na ciąg JSON przy użyciu polecenia cmdlet ConvertTo-Json, a następnie przekaż zmienną z ciągiem JSON jako jego wartością. To obejście zapewnia prawidłową obsługę zmiennej w środowisku usługi Azure Automation jako ciąg JSON.

  Przykład — tworzenie obiektu programu PowerShell, który zawiera informacje dotyczące maszyn wirtualnych platformy Azure

  azurepowershell
  
  # 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 
  

Ograniczenia

• W przypadku wersji środowiska uruchomieniowego programu PowerShell 7.2 działania modułu nie są wyodrębniane dla zaimportowanych modułów.
• Program PowerShell 7.x nie obsługuje przepływów pracy. Aby uzyskać więcej informacji, zobacz Przepływ pracy programu PowerShell, aby uzyskać więcej szczegółów.
• Program PowerShell 7.x obecnie nie obsługuje podpisanych runbooków.
• Integracja kontroli źródła nie obsługuje programu PowerShell 7.2. Ponadto runbooki programu PowerShell 7.2 w kontroli wersji są tworzone na koncie usługi Automation jako Runtime 5.1.
• Moduł Az 8.3.0 jest instalowany domyślnie. Pełna lista modułów składowych wybranej wersji modułu Az jest wyświetlana po ponownym skonfigurowaniu wersji modułu Az przy użyciu portalu Azure lub interfejsu API.
• Zaimportowany moduł programu PowerShell 7.2 zostanie zweryfikowany podczas wykonywania zadania. Upewnij się, że wszystkie zależności dla wybranego modułu są również importowane do pomyślnego wykonania zadania.
• Runbook platformy Azure nie obsługuje Start-Job z -credential.
• Platforma Azure nie obsługuje wszystkich parametrów wejściowych programu PowerShell. Dowiedz się więcej.

Znane problemy

• Runbooki zależne od wewnętrznych ścieżek plików, takich jak C:\modules, mogą ulec awarii z powodu zmian w infrastrukturze zaplecza usługi. Zmień kod elementu Runbook, aby upewnić się, że nie ma zależności od ścieżek plików wewnętrznych i użyj polecenia Get-ChildItem , aby uzyskać wymagane informacje o module.

• Get-AzStorageAccountPolecenie cmdlet może zakończyć się niepowodzeniem z powodu błędu: Get-AzStorageAccount polecenie zostało znalezione w module Az.Storage, ale nie można załadować modułu.

• Wykonywanie skryptów dzieci przy użyciu .\child-runbook.ps1 nie jest obsługiwane.
  Obejście: użyj Start-AutomationRunbook (wewnętrznego polecenia cmdlet) lub Start-AzAutomationRunbook (z modułu Az.Automation), aby uruchomić inny Runbook z nadrzędnego Runbooka.

• W przypadku korzystania z modułu ExchangeOnlineManagement w wersji 3.0.0 lub nowszej można napotkać błędy. Aby rozwiązać ten problem, upewnij się, że jawnie załadujesz moduły PowerShellGet i PackageManagement.

• Jeśli używasz New-AzAutomationVariable polecenia cmdlet w module Az.Automation do przekazania zmiennej typu object, operacja nie działa zgodnie z oczekiwaniami.

  Obejście: Przekonwertuj obiekt na ciąg JSON przy użyciu polecenia cmdlet ConvertTo-Json, a następnie przekaż zmienną z ciągiem JSON jako jego wartością. To obejście zapewnia prawidłową obsługę zmiennej w środowisku usługi Azure Automation jako ciąg JSON.

  Przykład — tworzenie obiektu programu PowerShell, który zawiera informacje dotyczące maszyn wirtualnych platformy Azure

    azurepowershell
  
    # 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 
  

Ograniczenia

• Runbooki nie mogą używać przetwarzania równoległego do wykonywania wielu akcji jednocześnie.
• Elementy Runbook nie mogą używać punktów kontrolnych do wznowienia elementu Runbook, jeśli wystąpi błąd.
• Można uwzględnić tylko elementy Runbook programu PowerShell, elementy Runbook przepływu pracy programu PowerShell i graficzne elementy Runbook jako podrzędne elementy Runbook przy użyciu polecenia cmdlet Start-AzAutomationRunbook , które tworzy nowe zadanie.
• Runbooki nie mogą używać instrukcji #Requires programu PowerShell, ponieważ nie jest ona obsługiwana w piaskownicy Azure ani na Hybrydowych Runbook Workerach i może spowodować niepowodzenie zadania.
• Runbook platformy Azure nie obsługuje Start-Job z -credential.
• Platforma Azure nie obsługuje wszystkich parametrów wejściowych programu PowerShell. Dowiedz się więcej.

Znane problemy

• Runbooki zależne od wewnętrznych ścieżek plików, takich jak C:\modules, mogą ulec awarii z powodu zmian w infrastrukturze zaplecza usługi. Zmień kod elementu Runbook, aby upewnić się, że nie ma zależności od ścieżek plików wewnętrznych i użyj polecenia Get-ChildItem , aby uzyskać wymagane informacje o module.

  Przykładowy skrypt

  
  # 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
  
  

• Get-AzStorageAccountPolecenie cmdlet może zakończyć się niepowodzeniem z powodu błędu: Get-AzStorageAccount polecenie zostało znalezione w module Az.Storage, ale nie można załadować modułu.

• Runbooki programu PowerShell nie mogą pobrać niezaszyfrowanego zasobu zmiennej z wartością null.

• Runbooki programu PowerShell nie mogą pobrać zasobu zmiennej z *~* w nazwie.

• Operacja Get-Process w pętli w runbooku PowerShell może zawiesić się po około 80 powtórzeniach.

• Element Runbook programu PowerShell może zakończyć się niepowodzeniem, jeśli próbuje zapisać dużą ilość danych do strumienia wyjściowego jednocześnie. Zazwyczaj można obejść ten problem, podając do danych wyjściowych elementu Runbook tylko informacje potrzebne do pracy z dużymi obiektami. Na przykład zamiast używać Get-Process polecenia bez ograniczeń, możesz mieć dane wyjściowe polecenia cmdlet tylko wymagane parametry, jak w pliku Get-Process | Select ProcessName, CPU.

• W przypadku korzystania z modułu ExchangeOnlineManagement w wersji 3.0.0 lub nowszej mogą wystąpić błędy. Aby rozwiązać ten problem, upewnij się, że jawnie przekażesz moduły PowerShellGet i PackageManagement .

• Jeśli importujesz moduł Az.Accounts z wersją 2.12.3 lub nowszą, upewnij się, że moduł Newtonsoft.Json v10 jawnie zaimportował, jeśli elementy Runbook programu PowerShell 5.1 mają zależność od tej wersji modułu. Obejściem tego problemu jest użycie elementów Runbook programu PowerShell 7.2.

• Jeśli używasz New-AzAutomationVariable polecenia cmdlet w module Az.Automation do przekazania zmiennej typu object, operacja nie działa zgodnie z oczekiwaniami.

  Obejście: Przekonwertuj obiekt na ciąg JSON przy użyciu polecenia cmdlet ConvertTo-Json, a następnie przekaż zmienną z ciągiem JSON jako jego wartością. To obejście zapewnia prawidłową obsługę zmiennej w środowisku usługi Azure Automation jako ciąg JSON.

  Przykład — tworzenie obiektu programu PowerShell, który zawiera informacje dotyczące maszyn wirtualnych platformy Azure

    # 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 
  

Ograniczenia

• PowerShell 7.1 nie jest już obsługiwany przez nadrzędny produkt PowerShell. Zalecamy utworzenie nowych elementów Runbook w programie PowerShell 7.4 w celu zapewnienia długoterminowej obsługi i zaktualizowania nieaktualnych elementów Runbook.
• Wewnętrzne polecenia cmdlet programu PowerShell usługi Azure Automation nie są obsługiwane na hybrydycznym pracowniku uruchamiania Runbook systemu Linux. Aby uzyskać dostęp do funkcji udostępnionych zasobów konta usługi Automation, należy zaimportować moduł automationassets na początku swojego runbooka programu PowerShell.
• W przypadku wersji środowiska uruchomieniowego programu PowerShell 7 działania modułu nie są wyodrębniane dla zaimportowanych modułów.
• Typ parametru elementu Runbook programu PSCredential nie jest obsługiwany w wersji środowiska uruchomieniowego programu PowerShell 7.
• Program PowerShell 7.x nie obsługuje przepływów pracy. Aby uzyskać więcej informacji, zobacz PowerShell Workflow (Przepływ pracy programu PowerShell), aby uzyskać więcej szczegółów.
• Program PowerShell 7.x obecnie nie obsługuje podpisanych runbooków.
• Integracja kontroli źródła nie obsługuje programu PowerShell 7.1 (wersja zapoznawcza) Ponadto elementy Runbook programu PowerShell 7.1 (wersja zapoznawcza) w kontroli źródła są tworzone na koncie usługi Automation jako środowisko uruchomieniowe 5.1.
• Zarządzanie modułami programu PowerShell 7.1 nie jest obsługiwane za pomocą poleceń cmdlet Get-AzAutomationModule.
• Element Runbook kończy się niepowodzeniem bez śladu dziennika, jeśli wartość wejściowa zawiera znak ".
• Runbook platformy Azure nie obsługuje Start-Job z -credential.
• Platforma Azure nie obsługuje wszystkich parametrów wejściowych programu PowerShell. Dowiedz się więcej.

Znane problemy

• Runbooki zależne od wewnętrznych ścieżek plików, takich jak C:\modules, mogą ulec awarii z powodu zmian w infrastrukturze zaplecza usługi. Zmień kod elementu Runbook, aby upewnić się, że nie ma zależności od ścieżek plików wewnętrznych i użyj polecenia Get-ChildItem , aby uzyskać wymagane informacje o module.

  Przykładowy skrypt

  
  # 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
  
  

• Get-AzStorageAccountPolecenie cmdlet może zakończyć się niepowodzeniem z powodu błędu: Get-AzStorageAccount polecenie zostało znalezione w module Az.Storage, ale nie można załadować modułu.

• Wykonywanie skryptów podrzędnych przy użyciu programu .\child-runbook.ps1 nie jest obsługiwane w tej wersji zapoznawczej. Obejście: użyj Start-AutomationRunbook (wewnętrznego polecenia cmdlet) lub Start-AzAutomationRunbook (z Az.Automation modułu), aby uruchomić inny element Runbook z nadrzędnego elementu Runbook.

• Właściwości elementu Runbook definiujące preferencje rejestrowania nie są obsługiwane w środowisku uruchomieniowym programu PowerShell 7. Obejście: Jawne ustawienie preferencji na początku elementu Runbook w następujący sposób:

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

• Unikaj importowania Az.Accounts modułu do wersji 2.4.0 dla środowiska uruchomieniowego programu PowerShell 7, ponieważ może wystąpić nieoczekiwane zachowanie przy użyciu tej wersji w usłudze Azure Automation.

• Mogą wystąpić problemy z formatowaniem strumieni wyjściowych błędów dla zadania uruchomionego w środowisku uruchomieniowym programu PowerShell 7.

• Podczas importowania modułu programu PowerShell 7.1 zależnego od innych modułów może się okazać, że przycisk importu jest szary, nawet jeśli jest zainstalowana wersja programu PowerShell 7.1 modułu zależnego. Na przykład moduł Az programu PowerShell. Środowisko obliczeniowe w wersji 4.20.0 ma zależność od modułu Az.Accounts = >2.6.0. Ten problem występuje, gdy równoważny moduł zależny w programie PowerShell 5.1 nie spełnia wymagań dotyczących wersji. Na przykład moduł Az.Accounts w wersji 5.1 był < 2.6.0.

• Po uruchomieniu runbooka PowerShell 7 za pomocą webhooka, jego parametr wejściowy jest automatycznie konwertowany na nieprawidłowy kod JSON.

• Zalecamy użycie modułu ExchangeOnlineManagement w wersji 3.0.0 lub starszej, ponieważ wersja: 3.0.0 lub nowsza może prowadzić do błędów zadań.

• W przypadku importowania modułu Az.Accounts w wersji 2.12.3 lub nowszej, upewnij się, że jawnie importujesz moduł Newtonsoft.Json w wersji v10, jeśli runbooki programu PowerShell 7.1 mają zależność od tej wersji modułu. Obejściem tego problemu jest użycie elementów Runbook programu PowerShell 7.2.

• Jeśli używasz New-AzAutomationVariable polecenia cmdlet w module Az.Automation do przekazania zmiennej typu object, operacja nie działa zgodnie z oczekiwaniami.

  Obejście: Przekonwertuj obiekt na ciąg JSON przy użyciu polecenia cmdlet ConvertTo-Json, a następnie przekaż zmienną z ciągiem JSON jako jego wartością. To obejście zapewnia prawidłową obsługę zmiennej w środowisku usługi Azure Automation jako ciąg JSON.

  Przykład — tworzenie obiektu programu PowerShell, który zawiera informacje dotyczące maszyn wirtualnych platformy Azure

    # 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 
  

• Obecnie w przypadku modułów języka Python 3.10 obsługiwane są tylko pliki wheel przeznaczone dla systemu operacyjnego Linux na platformie cp310. Dowiedz się więcej
• Integracja kontroli źródła nie jest obsługiwana.
• Pakiety niestandardowe dla języka Python 3.10 są weryfikowane tylko podczas wykonywania zadania. Zadanie ma zakończyć się niepowodzeniem, jeśli pakiet nie jest zgodny ze środowiskiem uruchomieniowym lub jeśli wymagane zależności pakietów nie są importowane na konto automatyzacji.
• Obecnie runbooki Pythona 3.10 są obsługiwane tylko z poziomu portalu Azure oraz API REST.

• Język Python 3.8 nie jest już obsługiwany przez produkt nadrzędny Python. Zalecamy utworzenie nowych runbooków w wersjach obsługiwanych i aktualizację przestarzałych runbooków.
• Musisz zapoznać się ze skryptami języka Python.
• Integracja kontroli źródła nie jest obsługiwana.
• W przypadku modułów języka Python 3.8 użyj plików wheel przeznaczonych dla cp38-amd64.
• Aby korzystać z bibliotek innych firm, należy zaimportować pakiety na konto usługi Automation.
• Korzystanie z polecenia Start-AutomationRunbook cmdlet w PowerShell/Workflow PowerShell do uruchomienia runbooka Python 3.8 nie działa. Aby obejść to ograniczenie, możesz użyć polecenia cmdlet Start-AzAutomationRunbook z modułu Az.Automation lub polecenia cmdlet Start-AzureRmAutomationRunbook z modułu AzureRm.Automation. 
• Usługa Azure Automation nie obsługuje narzędzia sys.stderr.
• Pakiet zasobów automatyzacji języka Python nie jest dostępny w pypi.org, więc nie jest dostępny do importowania na maszynę z systemem Windows.

• Język Python 2.7 nie jest już obsługiwany przez produkt nadrzędny Python. Zalecamy utworzenie nowych runbooków w obsługiwanych wersjach i zaktualizowanie nieaktualnych runbooków.
• Musisz zapoznać się ze skryptami języka Python.
• W przypadku modułów języka Python 2.7.12 użyj plików wheel cp27-amd6.
• Aby korzystać z bibliotek innych firm, należy zaimportować pakiety na konto usługi Automation.
• Usługa Azure Automation nie obsługuje narzędzia sys.stderr.
• Pakiet zasobów automatyzacji języka Python nie jest dostępny w pypi.org, więc nie jest dostępny do importowania na maszynę z systemem Windows.