با Microsoft Graph PowerShell به Microsoft 365 متصل شوید
این مقاله برای Microsoft 365 Enterprise و Office 365 Enterprise کاربرد دارد.
Microsoft Graph PowerShell شما را قادر می سازد تنظیمات Microsoft 365 خود را از خط فرمان مدیریت کنید. این مقاله به شما نشان می دهد که چگونه نرم افزار مورد نیاز را نصب کنید و سپس با استفاده از Microsoft Graph PowerShell SDK به سازمان مایکروسافت 365 متصل شوید.
در حال حاضر، ماژول Azure Active Directory Power Shell for Graph به طور کامل جایگزین عملکرد ماژول Microsoft Azure Active Directory برای Windows PowerShell برای مدیریت پروکسی برنامه، مدیریت کاربر و مخاطبین نمی شود. در برخی موارد، باید از هر دو نسخه استفاده کنید. می توانید با خیال راحت هر دو نسخه را روی یک رایانه نصب کنید.
توجه داشته باشید : ماژول Azure Active Directory (AzureAD) Power Shell در حال منسوخ شدن است و با Microsoft Graph PowerShell SDK جایگزین شده است. میتوانید از Microsoft Graph Power Shell SDK برای دسترسی به همه APIهای Microsoft Graph استفاده کنید.
پیش نیازها
PowerShell 7 و بالاتر، نسخه PowerShell توصیه شده برای استفاده با Microsoft Graph PowerShell SDK در همه پلتفرمها است. هیچ پیش نیاز دیگری برای استفاده از SDK با PowerShell 7 یا جدیدتر وجود ندارد.
برای استفاده از Microsoft Graph PowerShell SDK با Windows PowerShell، پیش نیازهای زیر لازم است.
- به PowerShell 5.1 یا بالاتر ارتقا دهید
- .NET Framework 4.7.2 یا بالاتر را نصب کنید
- PowerShellGet را با استفاده از Install-Module PowerShellGet به آخرین نسخه به روز کنید
خط مشی اجرای اسکریپت PowerShell باید روی امضای راه دور یا کمتر محدودکننده تنظیم شود. از Get-ExecutionPolicy برای تعیین خط مشی اجرایی فعلی استفاده کنید.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
سیستم عامل
شما باید از نسخه 64 بیتی ویندوز استفاده کنید. می توانید از نسخه های زیر ویندوز استفاده کنید:
- Windows 11، Windows 10، Windows 8.1، Windows 8 یا Windows 7 Service Pack 1 (SP1)
- Windows Server 2019، Windows Server 2016، Windows Server 2012 R2، Windows Server 2012 یا Windows Server 2008 R2 SP1
توجه داشته باشید : برای Windows 8.1، Windows 8، Windows 7 Service Pack 1 (SP1)، Windows Server 2012 R2، Windows Server 2012 و Windows Server 2008 R2 SP1، Windows Management Framework 5.1 را دانلود و نصب کنید.
برای استفاده از Microsoft Graph Power Shell، باید حداقل از Power Shell نسخه 5.1 استفاده کنید.
توجه داشته باشید این رویه ها برای کاربرانی در نظر گرفته شده است که عضو یک نقش مدیر Microsoft 365 هستند.
با Microsoft Graph PowerShell متصل شوید
در این بخش، نحوه اتصال به سازمان Microsoft 365 خود را با استفاده از Microsoft Graph PowerShell SDK یاد خواهید گرفت. برای راهنمایی بیشتر می توانید به نصب Microsoft Graph Power Shell SDK مراجعه کنید.
مرحله 1: نرم افزار مورد نیاز را نصب کنید
Microsoft Graph PowerShell SDK در گالری Power Shell منتشر شده است.
این مراحل فقط یک بار در رایانه شما لازم است. با این حال، احتمالاً باید نرم افزار را به صورت دوره ای به روز کنید.
ماژول Microsoft Graph PowerShell SDK و ماژول بتا را نصب کنید.
Microsoft Graph Power Shell SDK در دو ماژول Microsoft.Graph و Microsoft.Graph.Beta عرضه می شود که شما جداگانه نصب خواهید کرد. این ماژول ها به ترتیب Microsoft Graph v1.0 و Microsoft Graph بتا را می نامند. می توانید این دو ماژول را روی یک نسخه PowerShell نصب کنید.
- یک پنجره Windows Power Shell Command Prompt را باز کنید. بسته به مجوزهای حساب وارد شده خود، ممکن است لازم باشد پنجره PowerShell را در حالت Administrator باز کنید.
- برای نصب ماژول v1 SDK در PowerShell Core یا Windows PowerShell، دستور زیر را اجرا کنید:
- برای نصب ماژول بتا این دستور را اجرا کنید:
Install-Module Microsoft.Graph.Beta
پس از اتمام نصب، می توانید نسخه نصب شده را با دستور زیر تأیید کنید:
Get-InstalledModule Microsoft.Graph
مرحله 2: به اشتراک Microsoft 365 خود متصل شوید
PowerShell SDK از دو نوع احراز هویت پشتیبانی می کند: دسترسی تفویض شده و دسترسی فقط برنامه. در این راهنما، از دسترسی تفویض شده برای ورود به عنوان کاربر، رضایت SDK برای اقدام از جانب شما و تماس با Microsoft Graph استفاده میکنید.
محدوده مجوز مورد نیاز را تعیین کنید
هر API در گراف مایکروسافت توسط یک یا چند محدوده مجوز محافظت می شود. کاربری که وارد سیستم میشود باید با یکی از حوزههای مورد نیاز برای APIهایی که قصد استفاده از آن را دارید، رضایت دهد. در این مثال از API های زیر استفاده خواهیم کرد.
- کاربران را فهرست کنید تا شناسه کاربری کاربر وارد شده را پیدا کنید.
- joinedTeams را فهرست کنید تا تیمهایی را که کاربر در آنها عضویت دارد، دریافت کنید.
- برای دریافت کانالها در یک تیم، کانالها را فهرست کنید.
- برای ارسال پیام به کانال یک تیم پیام ارسال کنید.
محدوده مجوز User.Read.All دو تماس اول را فعال می کند و دامنه Group.ReadWrite.All بقیه را فعال می کند. این مجوزها به یک حساب کاربری نیاز دارند.
برای اتصال به سازمان مایکروسافت 365، دستور زیر را اجرا کنید:
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
این فرمان از شما میخواهد که به یک صفحه وب بروید تا با اعتبار خود وارد شوید. هنگامی که این کار را انجام دادید، فرمان موفقیت را با یک Welcome To Microsoft Graph نشان می دهد! پیام شما فقط باید یک بار در هر جلسه وارد شوید.
نکته : میتوانید با تکرار فرمان Connect-MgGraph با دامنههای مجوز جدید، مجوزها را بهطور دقیق اضافه کنید.
برای خرید لایسنس نرم افزار Power BI ، میتوانید از خدمات ما استفاده نموده و درخواست خود را از طریق فرم زیر ثبت نمایید.