استخدام أوامر PowerShell cmdlet الخاصة بالنشر المركزي لإدارة الوظائف الإضافية

بصفتك مسؤول Office 365، يمكنك نشر وظائف للمستخدمين عبر ميزة "النشر المركزي" (اطلع على وظائف Office الإضافية في مركز إدارة Office 365‏). بالإضافة إلى نشر وظائف Office الإضافية عبر مركز إدارة Office 365، يمكنك أيضاً استخدام Microsoft PowerShell. قم بـ تنزيل أوامر PowerShell cmdlet الخاصة بالنشر المركزي من مركز التنزيل لـ 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‏.

تحميل بيان الوظيفة الإضافية

شغّل الأمر New-OrganizationAdd-In cmdlet حتى يتم تحميل بيان الوظيفة الإضافية من مسار، الذي قد يكون موقع ملف أو عنوان URL. يوضح المثال التالي موقع ملف لقيمة المعلمة ManifestPath.

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

يمكنك أيضاً تشغيل New-OrganizationAdd-In cmdlet لتحميل وظيفة إضافية وتعيينها إلى المستخدمين أو المجموعات مباشرة باستخدام المعلمة Members، كما هو موضح في المثال التالي. افصل عناوين البريد الإلكتروني للأعضاء باستخدام فاصلة.

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

تحميل وظيفة إضافية من متجر Office‏

شغّل الأمر New-OrganizationAdd-In cmdlet لتحميل بيان من متجر Office.

في المثال التالي، يحدد New-OrganizationAddIn cmdlet AssetId لوظيفة إضافية لسوق المحتوى والموقع للولايات المتحدة.

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

لتحديد القيمة للمعلمة AssetId، يمكنك نسخها من عنوان URL لصفحة الويب متجر Office للوظيفة الإضافية. يبدأ AssetIds دائماً بـ "WA" يتبعه رقم. على سبيل المثال، في المثال السابق، كان المصدر لقيمة AssetId لـ WA104099688 هو عنوان صفحة ويب متجر Office للوظيفة الإضافية: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

قيم المعلمة Locale والمعلمة ContentMarket متماثلة وتشير إلى البلد/المنطقة التي تحاول تثبيت الوظيفة الإضافية منها. التنسيق هو en-US ،FR-FR وهكذا دواليك.

ملاحظة: سيتم تحديث الوظائف الإضافية التي تم تحميلها من متجر Office تلقائياً خلال بضعة أيام لتوفر التحديث الأخير على متجر Office.

الحصول على تفاصيل حول وظيفة إضافية

شغّل الأمر Get-OrganizationAddIn cmdlet كما هو موضح أدناه للحصول على التفاصيل الخاصة بجميع الوظائف الإضافية التي تم تحميلها إلى المستأجر، متضمنة معرّف المنتج لوظيفة إضافية.

Get-OrganizationAddIn

شغّل الأمر Get-OrganizationAddIn cmdlet بقيمة المعلمة ProductId لتحديد الوظيفة الإضافية التي تحتاج إلى استرداد تفاصيل.

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

للحصول على التفاصيل الكاملة لجميع الوظائف الإضافية بالإضافة إلى المجموعات والمستخدمين المعينين، قم بتوجيه إخراج الأمر Get-OrganizationAddIn cmdlet إلى Format-List cmdlet، كما هو موضح في المثال التالي.

Get-OrganizationAddIn |Format-List

تشغيل وظيفة إضافية أو إيقاف تشغيلها

لإيقاف تشغيل وظيفة إضافية حتى لا يتمكن المستخدمون والمجموعات التي تم تعيينهم إليها من الوصول إليها، شغّل الأمر Set-OrganizationAddIn cmdlet باستخدام المعلمة 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

إضافة مستخدمين أو إزالتهم من وظيفة إضافية

لإضافة مستخدمين ومجموعات إلى وظيفة معينة، شغّل Set-OrganizationAddInAssignments cmdlet باستخدام المعلمات 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

تحديث وظيفة إضافية

لتحديث وظيفة إضافية من بيان، شغّل الأمر Set-OrganizationAddIn cmdlet باستخدام المعلمات ProductId وManifestPath وLocale، كما هو موضح في المثال التالي.

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

ملاحظة: سيتم تحديث الوظائف الإضافية التي تم تحميلها من متجر Office تلقائياً خلال بضعة أيام لتوفر التحديث الأخير على متجر Office.

حذف وظيفة إضافية

لحذف وظيفة إضافية، شغّل الأمر Remove-OrganizationAddIn cmdlet باستخدام المعلمة ProductId، كما هو موضح في المثال التالي.

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

الحصول على تعليمات تفصيلية لكل أمر من أوامر cmdlet‏

يمكنك الاطلاع على تعليمات تفصيلية لكل أمر من أوامر cmdlet باستخدام Get-help cmdlet. علي سبيل المثال، يوفر الأمر cmdlet التالي معلومات تفصيلية حول الأمر Remove-OrganizationAddIn cmdlet.

Get-help Remove-OrganizationAddIn -Full
توسيع المهارات
استكشاف التدريب
الحصول على الميزات الجديدة أولاً
الانضمام إلى Office Insider

هل كانت المعلومات مفيدة؟

نشكرك على ملاحظاتك!

شكراً لك على الملاحظات! يبدو أنه من المفيد إيصالك بأحد وكلاء دعم Office لدينا.

×