Share via

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppRoleAssignmentRequired

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorUrl

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Homepage

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

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

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

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

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplyUrls

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalNames

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

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

-ServicePrincipalType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

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

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

ملاحظات

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