Microsoft Graph PowerShell ile Microsoft 365'e bağlanma
Bu makale hem Microsoft 365 Kurumsal hem de Office 365 Kurumsal için geçerlidir.
Microsoft Graph PowerShell, Microsoft 365 ayarlarınızı komut satırından yönetmenizi sağlar. Bu makalede gerekli yazılımları yükleme ve ardından Microsoft Graph PowerShell SDK'sını kullanarak Microsoft 365 kuruluşunuza bağlanma adımları gösterilmektedir.
Şu anda Graph için Azure Active Directory PowerShell modülü, uygulama ara sunucusu yönetimi, kullanıcı ve kişi yönetimi için Windows PowerShell için Microsoft Azure Active Directory modülünün işlevselliğini tamamen değiştirmez. Bazı durumlarda, her iki sürümü de kullanmanız gerekir. Her iki sürümü de aynı bilgisayara güvenle yükleyebilirsiniz.
Başlamadan önce bilmeniz gerekenler
Not
Azure Active Directory (AzureAD) PowerShell modülü kullanım dışı bırakılıyor ve yerini Microsoft Graph PowerShell SDK'sı aldı. Tüm Microsoft Graph API'lerine erişmek için Microsoft Graph PowerShell SDK'sını kullanabilirsiniz. Daha fazla bilgi için bkz. Microsoft Graph PowerShell SDK'sını kullanmaya başlama.
Ayrıca sırasıyla Microsoft Graph PowerShell'i yükleme ve Microsoft Graph PowerShell'e yükseltme hakkında bilgi için bkz. Microsoft Graph PowerShell SDK'sını yükleme ve Azure AD PowerShell'den Microsoft Graph PowerShell'e yükseltme.
Önkoşullar
PowerShell 7 ve üzeri, tüm platformlarda Microsoft Graph PowerShell SDK'sı ile kullanmak için önerilen PowerShell sürümüdür. SDK'yi PowerShell 7 veya üzeriyle kullanmak için başka bir önkoşul yoktur.
Windows PowerShell ile Microsoft Graph PowerShell SDK'sını kullanmak için aşağıdaki önkoşullar gereklidir.
- PowerShell 5.1 veya sonraki bir sürümüne yükseltme
- .NET Framework 4.7.2 veya üzerini yükleme
- Install-Module PowerShellGet kullanarak PowerShellGet'i en son sürüme güncelleştirme
PowerShell betiği yürütme ilkesi, uzaktan imzalanmış veya daha az kısıtlayıcı olarak ayarlanmalıdır. Geçerli yürütme ilkesini belirlemek için Get-ExecutionPolicy kullanın. Daha fazla bilgi için bkz. about_Execution_Policies. Yürütme ilkesini ayarlamak için şunu çalıştırın:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
İşletim sistemi
Windows'un 64 bit sürümünü kullanmanız gerekir. Aşağıdaki Windows sürümlerini kullanabilirsiniz:
Windows 11, Windows 10, Windows 8.1, Windows 8 veya Windows 7 Service Pack 1 (SP1)
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 veya Windows Server 2008 R2 SP1
Not
Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 ve Windows Server 2008 R2 SP1 için Windows Management Framework 5.1'i indirip yükleyin.
Microsoft Graph PowerShell'i kullanmak için en az PowerShell sürüm 5.1'i kullanmanız gerekir.
Not
Bu yordamlar, Microsoft 365 yönetici rolünün üyesi olan kullanıcılara yöneliktir. Daha fazla bilgi için bkz. Yönetici rolleri hakkında.
Microsoft Graph PowerShell ile bağlanma
Bu bölümde, Microsoft Graph PowerShell SDK'sını kullanarak Microsoft 365 kuruluşunuza bağlanmayı öğreneceksiniz. Daha fazla kılavuz için Microsoft Graph PowerShell SDK'sını yükleme sayfasını ziyaret edebilirsiniz.
1. Adım: Gerekli yazılımı yükleme
Microsoft Graph PowerShell SDK'sı PowerShell Galerisi yayımlanır.
Bu adımlar bilgisayarınızda yalnızca bir kez gereklidir. Ancak, büyük olasılıkla yazılımı düzenli aralıklarla güncelleştirmeniz gerekir.
Microsoft Graph PowerShell SDK'sını ve beta modülünü yükleme
Microsoft Graph PowerShell SDK'sı, microsoft.graph ve Microsoft.Graph.Beta olarak iki modülde sunulur ve bunlar ayrı ayrı yüklenir. Bu modüller sırasıyla Microsoft Graph v1.0 ve Microsoft Graph beta uç noktalarını çağırır. İki modülü aynı PowerShell sürümüne yükleyebilirsiniz.
bir Windows PowerShell Komut İstemi penceresi açın. Oturum açmış hesabınızın izinlerine bağlı olarak, PowerShell penceresini Yönetici modunda açmanız gerekebilir.
SDK'nın v1 modülünü PowerShell Core'a veya Windows PowerShell yüklemek için aşağıdaki komutu çalıştırın:
Install-Module Microsoft.Graph -Scope CurrentUserBeta modülünü yüklemek için şu komutu çalıştırın:
Install-Module Microsoft.Graph.Beta
Yükleme tamamlandıktan sonra, aşağıdaki komutla yüklü sürümü doğrulayabilirsiniz:
Get-InstalledModule Microsoft.Graph
2. Adım: Microsoft 365 aboneliğinize bağlanma
PowerShell SDK'sı iki tür kimlik doğrulamasını destekler: temsilci erişimi ve yalnızca uygulama erişimi. Bu kılavuzda kullanıcı olarak oturum açmak, SDK'ya sizin adınıza işlem yapmak için onay vermek ve Microsoft Graph'ı çağırmak için temsilcili erişimi kullanacaksınız.
Katılımsız senaryolar için yalnızca uygulama erişimini kullanma hakkında ayrıntılı bilgi için bkz. Microsoft Graph PowerShell SDK'sı ile yalnızca uygulama kimlik doğrulamasını kullanma.
Gerekli izin kapsamlarını belirleme
Microsoft Graph'taki her API bir veya daha fazla izin kapsamıyla korunur. Oturum açan kullanıcının, kullanmayı planladığınız API'ler için gerekli kapsamlardan birine onay vermesi gerekir. Bu örnekte aşağıdaki API'leri kullanacağız.
- Oturum açmış kullanıcının kullanıcı kimliğini bulmak için kullanıcıları listeleyin.
- Kullanıcının üyesi olduğu Teams'i almak için katılmışTeam'leri listeleyin.
- Bir Ekipteki kanalları almak için kanalları listeleyin.
- Ekibin kanalına ileti göndermek için ileti gönderin.
User.Read.All izin kapsamı ilk iki çağrıyı etkinleştirir ve Group.ReadWrite.All kapsamı geri kalanı etkinleştirir. Bu izinler için bir yönetici hesabı gerekir.
Hangi izin kapsamlarına ihtiyacınız olduğunu belirleme hakkında daha fazla bilgi için bkz. Find-MgGraphCommand kullanma.
Microsoft 365 Kuruluşunuza bağlanmak için aşağıdaki komutu çalıştırın:
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
Komut, kimlik bilgilerinizle oturum açmak için bir web sayfasına gitmenizi ister. Bunu yaptıktan sonra komut, Microsoft Graph'a Hoş Geldiniz! iletisiyle başarılı olduğunu gösterir. Oturum başına yalnızca bir kez oturum açmanız gerekir.
İpucu
Connect-MgGraph komutunu yeni izin kapsamlarıyla yineleyerek, izinler ekleyebilirsiniz.