שתף באמצעות

שימוש ברכיבי ה- cmdlet של PowerShell של פריסה מרוכזת לניהול תוספות

  • מאמר

כמנהל משתמש של Microsoft 365, באפשרותך לפרוס תוספות של Office למשתמשים באמצעות תכונת הפריסה המרוכזת (ראה פריסת תוספות Office במרכז הניהול). בנוסף לפריסת תוספות Office דרך מרכז הניהול של Microsoft 365, באפשרותך גם להשתמש ב- Microsoft PowerShell. התקן את מודול הפריסה של O365 Add-In עבור Windows PowerShell.

לאחר הורדת המודול, פתח חלון Windows PowerShell רגיל והפעל את ה- cmdlet הבא:

 Import-Module -Name O365CentralizedAddInDeployment

התחבר באמצעות אישורי מנהל המערכת שלך

כדי שתוכל להשתמש ברכיבי ה- cmdlet של פריסה מרוכזת, עליך להיכנס.

  1. הפעל את PowerShell.

  2. התחבר ל- PowerShell באמצעות אישורי מנהל המשתמש שלך. הפעל את ה- cmdlet הבא.

Connect-OrganizationAddInService
  1. בשורת הכניסה שנפתחת, בחר או הזן את אישורי מנהל המשתמשים של Microsoft 365.

הערה

לקבלת מידע נוסף אודות השימוש ב- PowerShell, ראה התחברות ל- Microsoft 365 באמצעות PowerShell.

העלאת מניפסט תוספת

הפעל את ה- cmdlet New-OrganizationAdd-In כדי להעלות מניפסט תוספת מנתיב, שיכול להיות מיקום קובץ או כתובת URL. הדוגמה הבאה מציגה מיקום קובץ עבור הערך של הפרמטר ManifestPath .

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

באפשרותך גם להפעיל את ה- cmdlet New-OrganizationAdd-In כדי להעלות תוספת ולהקצות אותה ישירות למשתמשים או לקבוצות באמצעות הפרמטר Members , כפי שמוצג בדוגמה הבאה. הפרד את כתובות הדואר האלקטרוני של חברים באמצעות פסיק.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

העלאת תוספת מחנות Office

הפעל את ה- cmdlet New-OrganizationAddIn כדי להעלות מניפסט מחנות Office.

בדוגמה הבאה, ה- cmdlet New-OrganizationAddIn מציין את ה- AssetId עבור תוספת עבור מיקום ושוק תוכן בארצות הברית.

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

כדי לקבוע את הערך עבור הפרמטר AssetId , באפשרותך להעתיק אותו מכתובת ה- URL של דף האינטרנט של חנות Office עבור התוספת. AssetIds תמיד מתחילים ב- "WA" ואחריו מספר. לדוגמה, בדוגמה הקודמת, המקור עבור הערך AssetId של WA104099688 הוא כתובת ה- URL של דף האינטרנט של חנות Office עבור התוספת: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

הערכים עבור הפרמטר Locale והפרמטר ContentMarket זהים ומציינות את המדינה/אזור שמם אתה מנסה להתקין את התוספת. התבנית היא en-US, fr-FR וכן הלאה.

הערה

תוספות שהועלו מחנות Office יתעדכנו באופן אוטומטי תוך כמה ימים מהעדכון האחרון הזמין בחנות Office.

קבלת פרטים של תוספת

הפעל את ה- cmdlet Get-OrganizationAddIn כפי שמוצג להלן כדי לקבל פרטים על כל התוספות שהועלו לדייר, כולל מזהה מוצר של תוספת.

Get-OrganizationAddIn

הפעל את ה- cmdlet Get-OrganizationAddIn עם ערך עבור הפרמטר ProductId כדי לציין את התוספת שעבורה ברצונך לאחזר פרטים.

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

כדי לקבל פרטים מלאים על כל התוספות בנוסף לקבוצות ולמשתמשים שהוקצו, הוסף צינור לפלט של ה- cmdlet Get-OrganizationAddIn ל- cmdlet של Format-List, כפי שמוצג בדוגמה הבאה.

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

הפעלה או ביטול של תוספת

כדי לבטל תוספת כך שלמשתמשים ולקבוצות שהוקצו לה לא תהיה עוד גישה, הפעל את ה- cmdlet Set-OrganizationAddIn כאשר הפרמטר ProductId והפרמטר Enabled$falseמוגדרים ל- , כפי שמוצג בדוגמה הבאה.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

כדי להפעיל תוספת בחזרה, הפעל את אותו cmdlet כאשר הפרמטר Enabled מוגדר ל- $true.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

הוספה או הסרה של משתמשים בתוספת

כדי להוסיף משתמשים וקבוצות לתוספת ספציפית, הפעל את ה- cmdlet Set-OrganizationAddInAssignments עם הפרמטרים ProductId, Add ו - Members . הפרד את כתובות הדואר האלקטרוני של חברים באמצעות פסיק.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

כדי להסיר משתמשים וקבוצות, הפעל את אותו cmdlet באמצעות הפרמטר Remove .

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

כדי להקצות תוספת לכל המשתמשים בדייר, הפעל את אותו cmdlet באמצעות הפרמטר AssignToEveryone כאשר הערך מוגדר ל- $true.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

כדי לא להקצות תוספת לכולם חזרה למשתמשים ולקבוצות שהוקצו קודם לכן, באפשרותך להפעיל את אותו cmdlet ולבטל את הפרמטר AssignToEveryone על-ידי הגדרת הערך שלו ל- $false.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

עדכון תוספת

כדי לעדכן תוספת מתוך מניפסט, הפעל את ה- cmdlet Set-OrganizationAddIn עם הפרמטרים ProductId, ManifestPath ו- Locale , כפי שמוצג בדוגמה הבאה.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

הערה

תוספות שהועלו מחנות Office יתעדכנו באופן אוטומטי תוך כמה ימים מהעדכון האחרון הזמין בחנות Office.

מחיקת תוספת

כדי למחוק תוספת, הפעל את ה- cmdlet Remove-OrganizationAddIn עם הפרמטר ProductId , כפי שמוצג בדוגמה הבאה.

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

קבל עזרה מפורטת עבור כל cmdlet

באפשרותך לעיין בעזרה מפורטת עבור כל cmdlet באמצעות ה- cmdlet Get-help. לדוגמה, ה- cmdlet הבא מספק מידע מפורט אודות Remove-OrganizationAddIn cmdlet.

Get-help Remove-OrganizationAddIn -Full