New-ServicePrincipal

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Online, Security & Compliance, Exchange Online Protection

Этот командлет доступен только в облачной службе.

Используйте командлет New-ServicePrincipal для создания субъектов-служб в облачной организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-ServicePrincipal
   -AppId <String>
   -ServiceId <String>
   [-Confirm]
   [-DisplayName <String>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Субъекты-службы существуют в Azure Active Directory, чтобы определить, что приложения могут делать, кто может получить доступ к приложениям и к каким ресурсам приложения могут получить доступ. В Exchange Online субъекты-службы являются ссылками на субъекты-службы в Azure AD. Чтобы назначить Exchange Online роли управления доступом на основе ролей (RBAC) субъектам-службам в Azure AD, используйте ссылки на субъекты-службы в Exchange Online. Командлеты *-ServicePrincipal в Exchange Online PowerShell позволяют просматривать, создавать и удалять ссылки на эти субъекты-службы.

Дополнительные сведения см. в статье Объекты приложения и субъекта-службы в Azure Active Directory.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

New-ServicePrincipal -AppId 71487acd-ec93-476d-bd0e-6c8b31831053 -ServiceId 6233fba6-0198-4277-892f-9275bf728bcc

В этом примере создается субъект-служба в Exchange Online с указанными значениями AppId и ServiceId.

Параметры

-AppId

Параметр AppId задает уникальное значение идентификатора GUID AppId для субъекта-службы. Например, ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.

Допустимое значение для этого параметра доступно в следующих расположениях:

Свойство AppId в выходных данных командлета Get-MgServicePrincipal в Microsoft Graph PowerShell.
Свойство Идентификатор приложения из корпоративных приложений на портале Azure AD: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-DisplayName

Параметр DisplayName указывает понятное имя субъекта-службы. Если имя содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ServiceId

Параметр ServiceId задает уникальное значение GUID ServiceId для субъекта-службы. Например, 7c7599b2-23af-45e3-99ff-0025d148e929.

Свойство ObjectId в выходных данных командлета Get-MgServicePrincipal в Microsoft Graph PowerShell.
Свойство Object ID из корпоративных приложений на портале Azure AD: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection