Microsoft Graph PowerShell Komut Dosyalarını Azure Otomasyonuyla Çalıştırma

Azure Otomasyon Hesapları, düzenli raporlama, otomatik olay iyileştirme ve yönetim görevlerinin otomasyonu gibi komut dosyalarının kullanımı yoluyla katılımsız ve tekrarlanan görevleri gerçekleştirmenize olanak tanır. Azure Otomasyonu ile Microsoft Graph PowerShell arasındaki entegrasyon, Graph API'yi kullanarak ortamınızın yönetimi ve bakımı için sonsuz olanaklar sağlar.

Bu eğitimde size nasıl bir Azure Otomasyon hesabı oluşturabileceğinizi ve kullanıcı etkileşimi olmadan düzenli otomatik görevleri gerçekleştirmek için Microsoft Graph PowerShell betiğinizi nasıl entegre edebileceğinizi göstereceğim.

Önkoşullar

Bu eğitimde özetlenen adımları tamamlamak için aşağıdakilere sahip olduğunuzdan emin olmalısınız:

Azure Aboneliği
Genel yönetici erişimine sahip bir hesap

Otomasyon Hesapları Azure'da bulunan bir hizmet olduğundan faturalandırma amacıyla bir aboneliğe bağlanmaları gerekir. Ayrıca komut dosyanızın gözetimsiz çalışmasına izin vermek için gerekli izinlere izin vermek için bunu global bir yönetici hesabıyla yapmanız gerekir.

Azure AD Uygulaması Oluşturun ve İzin Atayın

Microsoft Graph PowerShell betiğinizi herhangi bir kullanıcı etkileşimi veya kimlik doğrulaması olmadan çalıştırmak için, Azure Active Directory'de betikteki eylemleri gerçekleştirmek için gerekli izinlere sahip yeni bir uygulama oluşturmanız gerekir. Microsoft Entra yönetim merkezinde oturum açarak başlayın ve aşağıdaki adımları izleyin:

1. Uygulamalar > Uygulama kayıtları'nı seçin.

2. Sayfanın üst kısmında Yeni kayıt'ı seçin.

3. Uygulama için anlamlı bir ad tanımlayın, Yalnızca bu kuruluş dizinindeki hesaplar 'ı seçin ve ardından Kaydol'u tıklayın.

4. Artık uygulamalarınıza ilgili izinleri atamanız gerekiyor. API izinlerini seçin.

5. İzin ekle'yi seçin, ardından yeni açılır pencereden Microsoft Graph'ı seçin.

6. İzin türü olarak Uygulama izinleri'ni seçin.

7. Listeden her izni arayın ve seçin, ardından tüm izinleriniz seçildikten sonra İzin ekle'yi tıklayın.

8. Artık uygulamanızın istenen izinleri kullanması için yönetici izni vermeniz gerekiyor. Varsayılan Dizin için yönetici izni ver'i tıklayın.

9. Yönetici izni verildikten sonra durum sütununda yeşil onay işaretleri gösterilecektir.

10. Son adım, betiğimizin uygulamada kimlik doğrulamasını yapacağı yöntemi yapılandırmaktır. Bunun için Microsoft Graph PowerShell'in 2. sürümünde bulunan bir istemci sırrını kullanacağız. Uygulama ayarları sayfanızda Sertifikalar ve sırlar'ı seçin.

11. Müşteri sırları > Yeni istemci sırrı'nı seçin.

12. Sırrın açıklamasını ve son kullanma tarihini tanımlayın (maksimum kullanım ömrü 2 yıl veya 730 gündür).

13. Komut dosyanızda kullanmak üzere gizli anahtarın Değerini kaydedin.

Bu kılavuzun amacı Microsoft Graph PowerShell'in Azure Otomasyonu ile nasıl kullanılacağını göstermek olduğundan, komut dosyalarınızdaki bir istemci sırrı ile uygulama izinlerini nasıl kullanacağınızı öğrenmek için diğer eğitimimi takip edin: Bir İstemci Sırrı ile Microsoft Graph PowerShell'e Nasıl Bağlanılır.

Azure Otomasyon Hesabı Oluşturma

PowerShell run-book'ları Azure Otomasyon Hesaplarının 'İşlem Otomasyonu' özelliklerinin bir parçasını oluşturduğundan, yapmamız gereken bir sonraki şey yeni bir otomasyon hesabı oluşturmaktır. Otomasyon Hesabı oluşturmak için aşağıdaki adımları izleyin:

1. http://portal.azure.com adresinde oturum açarak başlayın ve ardından Otomasyon Hesapları'nı arayın.

2. Otomasyon Hesapları sayfasında, yeni Otomasyon Hesabı sihirbazını başlatmak için Oluştur'u seçin.

3. Sihirbazın ilk sayfasında bu kaynağın ait olacağı aboneliği seçin (bu, faturalandırılacak aboneliktir). Ardından kaynak hesap adını, Otomasyon hesap adını ve bu kaynağın coğrafi olarak depolanacağı bölgeyi tanımlayın.

Son olarak, İncele ve Oluştur'u, ardından Oluştur'u tıklayın ve dağıtım tamamlanana kadar bekleyin.

Microsoft Graph PowerShell modüllerini içe aktarın

Varsayılan olarak Azure Otomasyonu, Azure kaynaklarını yönetmenize yardımcı olacak bir dizi PowerShell modülü içerir. Varsayılan modüllerin listesini görüntülemek için tam liste için Microsoft dokümanlar sayfasına bakın. Daha da önemlisi, Microsoft Graph PowerShell modüllerinin manuel olarak içe aktarılması gerekir. Modüllerin önizleme sürümlerini içe aktarmanız gerektiğinde de süreç biraz farklıdır. Microsoft Graph PowerShell'in güncel ve önizleme sürümlerini Azure Otomasyon Hesabınıza aktarmak için aşağıdaki adımları izleyin.

Microsoft Graph PowerShell'in güncel sürümlerini içe aktarın

1. Otomasyon Hesapları sayfasından yeni Otomasyon Hesabınızı seçin.

2. Paylaşılan kaynaklar başlığı altında Modüller'i seçin.

3. Yeni modül sihirbazını başlatmak için Modül ekle'yi seçin.

4. Galeriden göz at'ı ve ardından Galeriden göz atmak için burayı tıklayın düğmesini seçin.

5. Microsoft.Graph.Authentication modülünü arayarak başlayın, sonuçlar listesinden seçin ve sonraki sayfada Seç'i tıklayın.

6. İhtiyaç duyduğunuz her ek modül için 3 - 5 arasındaki adımları tekrarlayın.

Microsoft Graph PowerShell'in önizleme sürümlerini içe aktarın

Modül galerisi sayfası, Otomasyon Hesabınızda dağıtabileceğiniz önizleme modüllerini içermez. Önizleme modülünü dağıtmanın en uygun yolu, bunu doğrudan PowerShell Gallary web sitesinden yapmaktır. Azure Otomasyon hesabınıza bir önizleme modülü yüklemek için aşağıdaki adımları izleyin:

1. https://www.powershellgallery.com/packages/Microsoft.Graph/ adresine gidin ve Sürüm Geçmişi bölümünden dağıtmak istediğiniz önizleme sürümünü seçin. Bu örnekte 2.0.09-rc3 sürümünü seçiyorum.

2. Azure Otomasyonu aracılığıyla SDK'nın tamamını değil, yalnızca belirli modülleri dağıtabildiğiniz için Paket Ayrıntıları bölümünü genişletin ve dağıtmak istediğiniz modüle tıklayın.

URL'nin tarayıcınızda seçtiğiniz modülle eşleşecek şekilde değişeceğini fark edebilirsiniz, bunu manuel olarak da değiştirebilirsiniz.

3. Azure Otomasyonu sekmesi artık Yükleme Seçenekleri oturumu altında görünecektir. Bu sekmeyi açın ve Azure Otomasyonuna Dağıt'ı tıklayın.

4. Azure Otomasyon modülü içe aktarma sihirbazı için tarayıcınızda yeni bir pencere açılacaktır. Gerekirse kimlik doğrulaması yapın ve listeden Otomasyon Hesabınızı seçin.

5. Sonraki sayfada Tamam'a tıklayın ve dağıtımınızın tamamlanmasını bekleyin. Bunu Azure Portal'daki bildirim simgesinden göreceksiniz.

6. İçe aktarmanız gereken her modül için 1-5 arasındaki adımları tamamlayın.

Runbook ile otomasyon betiğini uygulama

Runbook'lar, Azure Otomasyon hesabınızın otomasyon bileşenini oluşturur. Runbook'lar Windows PowerShell'i temel alır ve sürüm, Runbook oluşturulurken belirtilen Çalışma Zamanı sürümüne göre belirlenir; kullanılabilir çalışma zamanı sürümleri şunları içerir:

Sürüm 5.1
Sürüm 7.1
Sürüm 7.2

Runbook'unuzu oluşturmak ve PowerShell betiğinizi eklemek için aşağıdaki adımları izleyin:

1. Otomasyon Hesabınızı açın ve İşlem Otomasyonu başlığı altında Runbook'lar'ı seçin.

2. Runbook oluştur'u seçin.

3. Runbook oluşturun sayfasında runbook'unuzun adını tanımlayın, Runbook türünü PowerShell olarak ve Çalışma zamanı sürümünü 5,1 olarak seçin ve ardından Oluştur'u tıklayın. b>.

4. Oluşturulduktan sonra PowerShell'i Düzenle penceresi açılacaktır. Açılmazsa Otomasyon hesabınızdaki Runbook sayfasına dönün, yeni Runbook'u seçin ve Düzenle'yi tıklayın.

5. PowerShell'i Düzenle penceresinden kod alanına komut dosyanızı ekleyin ve ardından Kaydet > Yayınla'yı tıklayın.

6. Beklendiği gibi çalıştığından emin olmak için artık Runbook'unuzu test etmelisiniz. Runbook'a genel bakış sayfanızdan Başlat'ı seçin.

7. Genel Bakış sayfasının altındaki Son İşler listesinden işi seçerek işin hatasız mı yoksa hatasız mı tamamlandığını doğrulayabilirsiniz.

8. Betiğin başarıyla tamamlanmaması durumunda sorunları çözmenize yardımcı olacak uyarıları veya hataları görüntülemek için her sekmeyi seçin.

Otomasyon çalıştırma zamanlamasını yapılandırma

Zamanlama, runbook'un tekrarlanan bir zamanlamaya göre çalıştığı süreyi tanımlar; betiğinizin günlük, haftalık ve hatta aylık olarak çalıştırılmasına ihtiyacınız varsa bu kullanışlıdır. Bu eğitim için senaryomu günlük olarak çalıştıracak bir program oluşturacağım. Runbook'unuzun zamanlamasını tanımlamak için aşağıdaki adımları izleyin:

1. Otomasyon Hesabınızı açın ve Paylaşılan Kaynaklar başlığı altında Planlar'ı seçin.

2. Planlar sayfasından Plan ekle'yi seçin.

3. Açılır pencerelerde program ayarlarınızı tanımlayın ve ardından Oluştur'u tıklayın.

Ad: Anlamlı bir ad girin.
Başlangıçlar: İstediğiniz başlangıç tarihini ve saatini ekleyin.
Saat Dilimi: Saat diliminizi belirtin.
Yineleme: Runbook'un bir zamanlamaya göre ne sıklıkta çalıştırılacağını belirtin.
Son kullanma tarihini ayarla: Runbook zamanlamasının ne zaman duracağını belirtin.

Özet

Artık Azure Otomasyonu kullanılarak bir zamanlamaya göre gözetimsiz çalışacak bir Microsoft Graph PowerShell betiğiniz var! Bu eğitimde şunları nasıl yapacağınızı öğrendiniz:

Betiğinizin uygulama izinleriyle çalışmasını desteklemek için bir Azure Uygulaması oluşturun
Azure Otomasyon Hesabı Oluşturma
Modülleri Azure Otomasyon Hesabınıza aktarın
Komut dosyanızı Runbook kullanarak uygulayın
Runbook'unuz için bir zamanlama tanımlayın