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

Значение true, если учетная запись субъекта-службы включена, в противном случае — значение false.

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

Задает массив имен субъектов-служб. На основе коллекции identifierURIs и свойства appId приложения эти URI используются для ссылки на субъект-службу приложения. Клиент будет использовать их для следующих способов:

  • заполните requiredResourceAccess с помощью команды "Разрешения для других приложений" на классическом портале 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.