Share via

Set-MsolServicePrincipal

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

التحديثات كيان خدمة في Microsoft Azure Active Directory.

بناء الجملة

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

الوصف

يقوم الأمر cmdlet Set-MsolServicePrincipal بتحديث كيان الخدمة في Microsoft Azure Active Directory. يمكن استخدامه لتحديث اسم العرض أو تمكين/تعطيل كيان الخدمة أو الموثوق به للتفويض أو أسماء الخدمة الأساسية (SPNs) أو العناوين.

أمثلة

مثال 1: تغيير الخصائص على كيان الخدمة

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

يحدث هذا الأمر الخصائص على كيان الخدمة المحدد. في هذا المثال، يحدد تحديثات لاسم العرض وSPNs. سيؤدي هذا إلى الكتابة فوق أي إعدادات سابقة.

مثال 2: تغيير العناوين على كيان الخدمة

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

يحدث هذا الأمر عناوين كيان الخدمة. في هذا المثال، العناوين الموجودة التي تم إنشاؤها مسبقا ("myApp1.com"، "myApp2.com") باستخدام الأمر cmdlet New-MsolServicePrincipalAddresses ، مقترنة بكيان الخدمة.

المعلمات

-AccountEnabled

هذه الخاصية محجوزة للاستخدام في المستقبل.

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

-Addresses

تحديد قائمة العناوين التي سيتم تحديث القائمة الموجودة والكتابة فوقها. إذا لم تحدد هذه المعلمة، فلن يتم تحديث الخاصية الموجودة. إذا قمت بتحديد قائمة فارغة، يتم مسح العناوين الموجودة. استخدم الأمر cmdlet New-MsolServicePrincipalAddress للمساعدة في إنشاء كائن قائمة العناوين.

Type:RedirectUri[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

يحدد معرف التطبيق الفريد المقترن بكيان الخدمة المراد تحديثه.

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

-DisplayName

يحدد اسم العرض الخاص بكيان الخدمة.

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

-ObjectId

يحدد معرف الكائن الفريد لمدير الخدمة المراد تحديثه.

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

-ServicePrincipalNames

يحدد قائمة SPNs التي سيتم تحديثها والكتابة فوقها الموجودة. إذا لم تحدد هذه المعلمة، فلن يتم تحديث الخاصية الموجودة. إذا قمت بتحديد قائمة فارغة، يتم مسح SPNs الموجودة، باستثناء SPN الذي يحتوي على قيمة AppId لمدير الخدمة. يجب أن يستخدم SPN أحد التنسيقات التالية:

  • appName
  • appName/hostname
  • عنوان URL صالح
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

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

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