Set-MsolServicePrincipal
Обновления субъект-службу в Microsoft Azure Active Directory.
Синтаксис
Set-MsolServicePrincipal
[-ObjectId <Guid>]
[-AppPrincipalId <Guid>]
[-DisplayName <String>]
[-ServicePrincipalNames <String[]>]
[-AccountEnabled <Boolean>]
[-Addresses <RedirectUri[]>]
[-TenantId <Guid>]
[<CommonParameters>]
Описание
Командлет Set-MsolServicePrincipal обновляет субъект-службу в Microsoft Azure Active Directory. Его можно использовать для обновления отображаемого имени, включения и отключения участника-службы, который является доверенным для делегирования, имен участников-служб или адресов.
Примеры
Пример 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")
Эта команда обновляет свойства указанного субъекта-службы. В этом примере он указывает обновления отображаемого имени и имен субъектов-служб. Предыдущие значения при этом перезаписываются.
Пример 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") с помощью командлета New-MsolServicePrincipalAddresses , связаны с субъектом-службой.
Параметры
-AccountEnabled
Это свойство зарезервировано для дальнейшего использования.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Addresses
Указывает список адресов, с помощью которого необходимо обновить и перезаписать существующий список. Если этот параметр не указан, существующее свойство не обновляется. Если указать пустой список, существующие адреса удаляются. Используйте командлет 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
Указывает список имен субъектов-служб, с помощью которых необходимо обновить и перезаписать существующий. Если этот параметр не указан, существующее свойство не обновляется. Если указать пустой список, существующие имена субъектов-служб удаляются, за исключением имени субъекта-службы, содержащего значение AppId субъекта-службы. Имя субъекта-службы должно использовать один из следующих форматов:
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 |
Связанные ссылки
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по