حتما برای شما نیز پیش آمده که بخواهید از امکانات پاورشل استفاده کنید و کدی را در شیرپوینت اجرا کنید. برای مثال آپلود فایلهای داخل یک فولدر، بروزرسانی یک فیلد از آیتمهای یک لیست، دسترسی دادن به یک شخص یا گروهی از اشخاص و دیگر مواردی که همگی در صورتی که بخواهیم به صورت دستی انجام دهیم کاری بسیار دشوار خواهد بود، برای حل این مشکل میتوانیم از PnP PowerShell استفاده نماییم.
ما در این مقاله قصد داریم نصب PnP PowerShell و شروع استفاده از آن را آموزش دهیم.
در پاورشل دستوری داریم به نام Install-Module که با استفاده از آن میتوان از یک کتابخانه آنلاین از module ها یک ماژول خاص را پیدا و نصب نماییم.
پاورشل ویندوز را به صورت Run As Administrator باز نمایید و دستور زیر را وارد نمایید:
Install-Module SharePointPnPPowerShell2019
درصورتی که پیشنیازی داشته باشد از شما confirm میگرد و نصب میکند برای مثال اینجا به بسته NuGet Provider نیاز داشته که دانلود و نصب کرده.
سپس از شما دوباره تایید میخواهد برای نصب 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 دستورات بسیاز زیادی دارد که به صورت کامل دارای داکیومنت میباشد میتوانید لیست دستورات را در پاورشل به این شکل ببینید:
Get-Command -Module *PnP*
و همچنین دستورات و توضیحات هر کدام را میتوانید در لینک زیر مشاهده نمایید:
https://msdn.microsoft.com/en-us/pnp_powershell/pnp-powershell-overview