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

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

איזו פעולה ברצונך לבצע?

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

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

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

קבלת פרטים אודות תוספת

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

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

עדכון תוספת

מחיקת תוספת

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

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

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

  1. הפעל את PowerShell.

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

    Connect-OrganizationAddInService
  3. בדף הזנת אישורים, הזן את אישורי מנהל המערכת הכללי שלך עבור Office 365. לחלופין, באפשרותך להזין את האישורים ישירות ב- cmdlet.

    הפעל את ה- cmdlet הבא המציין את אישורי מנהל המערכת שלך בחברה כאובייקט PSCredential.

    $secpasswd = ConvertTo-SecureString “MyPassword” -AsPlainText -Force
    $mycredentials = New-Object System.Management.Automation.PSCredential (“serviceaccount@contoso.com”, $secpasswd)
    Connect-OrganizationAddInService -Credential $mycredentials

הערה: לקבלת מידע נוסף על השימוש ב- PowerShell, ראה התחברות ל- Office 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 עבור התוספת. ערכי AssetId תמיד מתחילים עם '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, כפי שמוצג בדוגמה הבאה.

Get-OrganizationAddIn |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 הבא מספק מידע מפורט אודות ה- cmdlet בשם Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full
הרחב את הכישורים שלך
סייר בהדרכה
קבל תכונות חדשות לפני כולם
הצטרף למשתתפי Office Insider

האם מידע זה היה שימושי?

תודה על המשוב!

תודה על המשוב! נראה שכדאי לקשר אותך לאחד מנציגי התמיכה של Office.

×