در این مقاله قصد داریم نحوه ایجاد یک کاربر شیرپوینت و گروه شیرپوینت و افزودن کاربر ایجاد شده به گروه شیرپوینت با استفاده از PnP PowerShell را مشاهده کنیم. مدل شیء سمت مشتری (CSOM) به صورت داخلی برای این عملیات استفاده می شود.
پيش نياز
قبل از اینکه شروع به استفاده از PowerShell برای نظارت بر شیرپوینت آنلاین کنید، مطمئن شوید که SharePoint Online Management Shell نصب شده است. شما می توانید با دانلود و اجرای پوسته مدیریت آنلاین شیرپوینت، پوسته مدیریت آنلاین شیرپوینت را نصب کنید . شما فقط باید این کار را یک بار برای هر کامپیوتری که از آن دستورات SharePoint Online PowerShell را اجرا می کنید انجام دهید.
اتصال به سایت
قبل از اتصال به سایت شیرپوینت، باید با استفاده از cmdlet Get-Credential که یک شی اعتبار برای یک نام کاربری و رمز عبور مشخص شده ایجاد می کند، اعتبارنامه را دریافت کنیم. شما می توانید از شی اعتبار در عملیات امنیتی استفاده کنید. به طور پیشفرض، یک کادر محاورهای احراز هویت ظاهر میشود که مانند تصویر مثال زیر از کاربر درخواست میکند
سپس با استفاده از cmdlet Connect-PnPOnline به سایت شیرپوینت متصل شوید. پارامترهای مورد نیاز عبارتند از -Url و -Credential. در -Url Parameter URL سایت و در -Credential دریافت-Credential را ارسال می کند.
قطعه کد زیر به اتصال سایت شیرپوینت کمک می کند.
- $credentials= Get-Credential
- $siteurl="https://<tenant-name>. sharepoint.com"
- Connect-PnPOnline -Url $siteurl -Credentials $credentials
ایجاد کاربر شیرپوینت
کاربران را می توان با استفاده از دستور New-MsolUser در سایت های شیرپوینت ایجاد کرد. cmdlet New-MsolUser یک کاربر در یک سایت شیرپوینت ایجاد کرد تا به کاربر امکان دسترسی به خدمات را بدهد. پارامترهای مورد نیاز عبارتند از
- UserPrincipalName - آدرس های ایمیل را برای کاربر مشخص می کند.
- DisplayName - نام نمایشی کاربر را مشخص می کند.
- FirstName - نام کوچک کاربر را مشخص می کند.
- LastName - نام خانوادگی کاربر را مشخص می کند.
قطعه زیر به ایجاد کاربر شیرپوینت در سایت شیرپوینت کمک می کند.
- Connect-MsolService -Credential $credentials
- New-MsolUser -UserPrincipalName "ravishankar@<tenant-name>.onmicrosoft.com" -DisplayName "Ravishankar" -FirstName "Ravi" -LastName "Shankar"
ایجاد گروه شیرپوینت
گروه ها را می توان با استفاده از دستور New-PnPGroup در سایت های شیرپوینت ایجاد کرد. پارامترهای مورد نیاز برای ایجاد یک گروه عنوان است. پارامترهای دیگری نیز می توانند اضافه شوند.
- مالک - نام ورود کاربر. اگر تخصیص داده نشود، نام ورود کاربر فعلی به طور پیش فرض اختصاص داده می شود.
- توضیحات - توضیحات گروه
قطعه زیر به ایجاد یک گروه شیرپوینت جدید در سایت شیرپوینت کمک می کند.
- $newGroup = New-PnPGroup -Title "Hubfly Group" -Owner "ravishankar@<tenant-name>. onmicrosoft.com" -Description "Hubfly Group"
مجوزها را روی SharePoint Group تنظیم کنید
مجوزهای گروه را می توان با استفاده از دستور Set-PnPGroupPermissions در سایت های SharePoint ایجاد کرد . پارامترهای مورد نیاز عبارتند از
- هویت - نام گروه را برای تنظیم مجوز بدهید
- AddRole - تعیین سطح مجوز برای گروه