مشاركة عبر

New-AzureADServicePrincipal

  • ‏‏المرجع
الوحدة النمطية:
AzureAD

إنشاء كيان خدمة.

بناء الجملة

New-AzureADServicePrincipal
   [-AccountEnabled <String>]
   [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
   -AppId <String>
   [-AppRoleAssignmentRequired <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-Homepage <String>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-LogoutUrl <String>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PublisherName <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-SamlMetadataUrl <String>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalType <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

أمثلة

مثال 1: إنشاء كيان خدمة

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

ينشئ هذا الأمر كيان خدمة. يتم استخدام العلامة "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" لإظهار كيان الخدمة هذا في قائمة التطبيقات المتكاملة في مدخل المسؤول.

المعلمات

-AccountEnabled

صحيح إذا تم تمكين الحساب الأساسي للخدمة؛ خلاف ذلك، خطأ.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

الأسماء البديلة لمدير الخدمة هذا

النوع:List<T>[String]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

المعرف الفريد للتطبيق المقترن (الخاصية appId الخاصة به).

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:True
Accept pipeline input:False
Accept wildcard characters:False

-AppRoleAssignmentRequired

يشير إلى ما إذا كان تعيين دور التطبيق مطلوبا أم لا.

النوع:Boolean
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

يحدد اسم العرض.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorUrl

يحدد عنوان URL للخطأ.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-Homepage

يحدد الصفحة الرئيسية.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

مجموعة بيانات الاعتماد الرئيسية المقترنة بكيان الخدمة.

النوع:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

يحدد عنوان URL لتسجيل الخروج.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

يحدد بيانات اعتماد كلمة المرور.

النوع:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

يحدد اسم الناشر.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplyUrls

عناوين URL التي يتم إرسال رموز المستخدم المميزة إليها لتسجيل الدخول باستخدام التطبيق المقترن، أو عناوين URIs لإعادة التوجيه التي يتم إرسال رموز تخويل OAuth 2.0 ورموز الوصول المميزة إليها للتطبيق المقترن.

النوع:List<T>[String]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

عنوان URL لبيانات تعريف SAML

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalNames

يحدد صفيفا من الأسماء الأساسية للخدمة. استنادا إلى مجموعة identifierURIs، بالإضافة إلى خاصية appId للتطبيق، يتم استخدام معرفات URIs هذه للإشارة إلى كيان خدمة التطبيق. سيستخدم العميل هذه من أجل:

  • قم بملء requiredResourceAccess، عبر "Permissions to other applications" في مدخل Microsoft Azure الكلاسيكي. - حدد URI لمورد للحصول على رمز مميز للوصول، وهو URI الذي تم إرجاعه في المطالبة.
النوع:List<T>[String]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

نوع THe لمدير الخدمة

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

العلامات المرتبطة بكيان الخدمة هذا.

لاحظ أنه إذا كنت تنوي ظهور كيان الخدمة هذا في قائمة جميع التطبيقات في مدخل المسؤول، فستحتاج إلى تعيين هذه القيمة إلى {WindowsAzureActiveDirectoryIntegratedApp}

النوع:List<T>[String]
Position:Named
القيمة الافتراضية:None
مطلوب:False
Accept pipeline input:False
Accept wildcard characters:False

ملاحظات

راجع دليل الترحيل ل New-AzureADServicePrincipal إلى Microsoft Graph PowerShell.