حتما برای شما نیز پیش آمده که بخواهید از امکانات پاورشل استفاده کنید و کدی را در شیرپوینت اجرا کنید. برای مثال آپلود فایل­‌های داخل یک فولدر، بروزرسانی یک فیلد از آیتم‌­های یک لیست، دسترسی دادن به یک شخص یا گروهی از اشخاص و دیگر مواردی که همگی در صورتی که بخواهیم به صورت دستی انجام دهیم کاری بسیار دشوار خواهد بود، برای حل این مشکل میتوانیم از PnP PowerShell استفاده نماییم.

ما در این مقاله قصد داریم نصب PnP PowerShell و شروع استفاده از آن را آموزش دهیم.

در پاورشل دستوری داریم به نام Install-Module  که با استفاده از آن میتوان از یک کتابخانه آنلاین از module ها یک ماژول خاص را پیدا و نصب نماییم.

پاورشل ویندوز را به صورت Run As Administrator باز نمایید و دستور زیر را وارد نمایید:

Install-Module SharePointPnPPowerShell2019

درصورتی که پیش‌نیازی داشته باشد از شما confirm میگرد و نصب میکند برای مثال اینجا به بسته NuGet Provider نیاز داشته که دانلود و نصب کرده.

نصب PnP PowerShell

سپس از شما دوباره تایید میخواهد برای نصب PNP-PowerShell پس از تایید دانلود و نصب مینماید:

نصب PnP PowerShell

اکنون که نصب کامل شد میتوانید دستورات PNP-PowerShell را اجرا نمایید.

در این ماژول مجموعه­ای کامل از دستورات جهت کار با یک سایت شیرپوینت فراهم شده است که در واقع این دستورات در نهایت به همان Powershell CSOM تبدیل خواهد شد.

اکنون میخواهیم به یک Site Collection شیرپوینت وصل شویم و آیتم های یک لیست خاص را فراخوانی کنیم:

Connect-PnPOnline –Url https://yoursitecollectionAddress –Credentials (Get-Credential)

براحتی با یک دستور به سایت مورد نظر وصل شدیم اکنون باید لیست مورد نظر را خوانده و آیتم های آنرا در خروجی چاپ کنیم:

get-PnPListItem -list “List Name”

در بعضی موارد پاورشل ممکن است از فارسی پشتیبانی ننماید برای حل این مشکل از PowerShell ISE استفاده نمایید و از اول به سایت وصل شده و دستور بالا را برای لیست مورد نظر بزنید:

نصب PnP PowerShell

اکنون با استفاده از PowerShell ISE :

PnP PowerShell دستورات بسیاز زیادی دارد که به صورت کامل دارای داکیومنت میباشد میتوانید لیست دستورات را در پاورشل به این شکل ببینید:

Get-Command -Module *PnP*

و همچنین دستورات و توضیحات هر کدام را میتوانید در لینک زیر مشاهده نمایید:

https://msdn.microsoft.com/en-us/pnp_powershell/pnp-powershell-overview

همچنین ما در رویداد #SharepointFriday ویدیو های کاملی از شرح PnP PowerShell و استفاده کاربردی از دستورات آنرا گذاشته­‌ایم.