Aktualizowanie modułów Azure PowerShell w usłudze Automation

Ten artykuł opisuje, jak zaktualizować moduły Azure PowerShell (Az) w Azure Automation. Moduł Az PowerShell to zestaw poleceń cmdlet umożliwiających zarządzanie zasobami Azure bezpośrednio z poziomu PowerShell. Azure Automation domyślnie udostępnia wspólne moduły PowerShell w każdym koncie Automaty. Więcej informacji można znaleźć w sekcji Domyślne moduły. Ponieważ zespół Azure regularnie aktualizuje moduły Azure, zmiany mogą wystąpić wraz z dołączonymi poleceniami cmdlet. Na przykład zmiana nazwy parametru lub całkowite wycofanie z pamięci cmdlet. Te zmiany mogą wpłynąć na istniejące runbooki i procesy automatyzacji, jeśli moduły nie zostaną odpowiednio zaktualizowane. Aby ułatwić zarządzanie tymi aktualizacjami, Azure Automation oferuje dwie metody aktualizacji modułów Az:

• Aktualizowanie modułów Az za pośrednictwem portalu Azure
• Zaktualizuj moduły Az za pomocą elementu runbook

Skonfiguruj konto Automation

Aby uniknąć wpływu na elementy Runbook i procesy, które automatyzują, należy przetestować i zweryfikować podczas wprowadzania aktualizacji. Jeśli nie masz dedykowanego konta usługi Automation przeznaczonego do tego celu, rozważ utworzenie takiego konta, aby można było przetestować wiele różnych scenariuszy podczas opracowywania elementów Runbook. Ten test powinien obejmować iteracyjne zmiany, takie jak aktualizowanie modułów programu PowerShell.

Upewnij się, że do konta Automation została dodana tożsamość zarządzana przypisana przez system lub tożsamość zarządzana przypisana przez użytkownika.

Jeśli tworzysz skrypty lokalnie, zaleca się posiadanie tych samych wersji modułów lokalnie, które masz na koncie usługi Automation podczas testowania, aby upewnić się, że otrzymasz te same wyniki. Po zweryfikowaniu wyników i wprowadzeniu wymaganych zmian możesz przenieść je do produkcji.

Aktualizowanie modułów Az

W poniższych sekcjach opisano, jak można zaktualizować moduły Az zarówno za pośrednictwem portalu (zalecane), jak i za pomocą elementu runbook.

Zaktualizuj moduły Az za pośrednictwem portalu Azure

Obecnie aktualizacja modułów Az jest dostępna tylko za pośrednictwem portalu. Aktualizacje za pomocą programu PowerShell i szablonu usługi ARM będą dostępne w przyszłości. Podczas wykonywania następujących kroków zostaną zaktualizowane tylko domyślne moduły AZ:

1. Zaloguj się do witryny Azure Portal i przejdź do swojego konta usługi Automation.

2. W obszarze Zasoby udostępnione wybierz pozycję Moduły.

3. Wybierz pozycję Aktualizuj moduły AZ.

4. Wybierz pozycję Moduł do aktualizacji. Domyślnie pokazuje moduł Az.

5. Z listy rozwijanej wybierz Moduł Wersja i Wersja Wykonawcza.

6. Wybierz Aktualizuj, aby zaktualizować moduł Az do wybranej przez Ciebie wersji. Na stronie Moduły możesz wyświetlić listę, jak pokazano poniżej:

   

Jeśli wybierzesz wersję niższą niż istniejąca wersja modułu AZ zaimportowana na koncie usługi Automation, operacja aktualizacji wykona wycofanie do wybranej niższej wersji.

Możesz zweryfikować operację aktualizacji, sprawdzając wersję modułu i właściwość statusu zaktualizowanych modułów pokazanych na liście modułów w obszarze Moduły programu PowerShell.

Zespół Azure regularnie aktualizuje wersję modułu i oferuje opcję aktualizacji domyślnych modułów Az poprzez wybór wersji modułu z listy rozwijanej.

Aktualizowanie modułów Az za pomocą elementu Runbook

Aby zaktualizować moduły Azure na koncie usługi Automation:

1. Użyj runbooka Update-AutomationAzureModulesForAccount dostępnego jako open source.
2. Pobierz z repozytorium GitHub, aby rozpocząć korzystanie z tego runbooka w celu zaktualizowania modułów Azure.
3. Zaimportuj go do konta usługi Automation lub uruchom go jako skrypt. Aby dowiedzieć się, jak zaimportować element Runbook na koncie usługi Automation, zobacz Importowanie elementu Runbook.

Runbook Update-AutomationAzureModulesForAccount obsługuje domyślną aktualizację modułów Azure, AzureRM i Az. Przejrzyj README aktualizacji modułów Azure, aby uzyskać więcej informacji na temat aktualizowania modułów Az. Moduły automatyzacji z tym runbookiem. Istnieją również inne ważne czynniki, które należy uwzględnić podczas korzystania z modułów Az na koncie usługi Automation. Aby dowiedzieć się więcej, zobacz Zarządzanie modułami w Azure Automation.

Używanie kodu Runbook aktualizacji jako zwykłego skryptu programu PowerShell

Kod Runbooka można użyć jako zwykłego skryptu PowerShell zamiast Runbooka. Aby to zrobić, najpierw zaloguj się do Azure, używając cmdletu Connect-AzAccount, a następnie przekaż -Login $false do skryptu.

Używanie elementu Runbook aktualizacji w suwerennych chmurach

Aby użyć tego runbooka w suwerennych chmurach, użyj parametru AzEnvironment, aby przekazać poprawne środowisko do runbooka. Dopuszczalne wartości to AzureCloud (Azure chmura publiczna), AzureChinaCloud, AzureGermanCloud i AzureUSGovernment. Można uzyskać te wartości, używając .Get-AzEnvironment | select Name Jeśli nie przekażesz wartości do tego polecenia cmdlet, element Runbook zostanie domyślnie przekazany do usługi AzureCloud.

Użyj Runbooka aktualizacji, aby zaktualizować określoną wersję modułu

Jeśli chcesz użyć konkretnej wersji modułu Azure PowerShell zamiast najnowszej dostępnej w Galeria programu PowerShell, przekaż tę wersję do opcjonalnego parametru ModuleVersionOverrides runbooka Update-AutomationAzureModulesForAccount. Aby zapoznać się z przykładami, zobacz runbook o nazwie Update-AutomationAzureModulesForAccount.ps1. Moduły Azure PowerShell, które nie zostały wymienione w parametrze ModuleVersionOverrides, są aktualizowane przy użyciu najnowszych wersji modułów w galerii PowerShell. Jeśli nic nie zostanie przekazane do parametru ModuleVersionOverrides, wszystkie moduły zostaną zaktualizowane o najnowsze wersje modułu w Galeria programu PowerShell. To zachowanie jest takie samo w przypadku Aktualizuj moduły Azure w portalu Azure.

Następne kroki

• Szczegóły dotyczące korzystania z modułów można znaleźć w artykule Manage modules in Azure Automation.
• Aby uzyskać informacje na temat runbooka aktualizacji, zobacz Update Azure modules runbook.
• Aby rozwiązać problemy podczas aktualizowania modułów Azure PowerShell zarządzanych jako zasoby udostępnione w Azure Automation, zobacz Rozwiązywanie problemów z zasobami udostępnionymi Azure Automation.