Поделиться через

Set-MsolServicePrincipal

  • Ссылка
Модуль:
MSOnline

Обновляет субъект-службу в 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

Это свойство зарезервировано для дальнейшего использования.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Addresses

Указывает список адресов, с помощью которого необходимо обновить и перезаписать существующий список. Если этот параметр не указан, существующее свойство не обновляется. Если указать пустой список, существующие адреса удаляются. Используйте командлет New-MsolServicePrincipalAddress , чтобы создать объект списка Адресов.

Тип:RedirectUri[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AppPrincipalId

Указывает уникальный идентификатор приложения, связанного с субъектом-службой для обновления.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DisplayName

Указывает отображаемое имя субъекта-службы.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ObjectId

Указывает уникальный идентификатор объекта субъекта-службы для обновления.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ServicePrincipalNames

Указывает список имен субъектов-служб, с помощью которых необходимо обновить и перезаписать существующие. Если этот параметр не указан, существующее свойство не обновляется. Если указать пустой список, существующие имена субъектов-служб очищаются, за исключением имени субъекта-службы, содержащего значение AppId субъекта-службы. Имя субъекта-службы должно использовать один из следующих форматов:

  • appName
  • appName/hostname
  • допустимый URL-адрес
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TenantId

Указывает уникальный идентификатор клиента, для которого выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям партнеров.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False