New-MsolServicePrincipal

语法

New-MsolServicePrincipal
   [-ServicePrincipalNames <String[]>]
   [-AppPrincipalId <Guid>]
   -DisplayName <String>
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-Type <ServicePrincipalCredentialType>]
   [-Value <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Usage <ServicePrincipalCredentialUsage>]
   [-TenantId <Guid>]
   [<CommonParameters>]

说明

New-MsolServicePrincipal cmdlet 创建一个服务主体，该服务主体可用于表示业务线 (LOB) 应用程序或本地服务器（如 Microsoft Azure Active Directory 中的 Microsoft Exchange、SharePoint 或 Lync）作为服务主体对象。 将新应用程序添加为服务主体将允许该应用程序向 Microsoft Office 365 等其他服务进行身份验证。

示例

示例 1：创建服务主体

PS C:\> New-MsolServicePrincipal -ServicePrincipalNames @("MyApp/myApp.com") -DisplayName "My Application"

此命令创建服务主体。 在此示例中，使用服务主体名称 MyApp/myApp.com、显示名称“我的应用程序”创建服务主体，并使用自动生成的 256 位对称密钥来验证应用程序。 此密钥的有效期为自当日起的一年。

示例 2：创建使用 X509 证书的服务主体

PS C:\> $cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate
PS C:\> $cer.Import("C:\temp\myapp.cer")
PS C:\> $binCert = $cer.GetRawCertData()
PS C:\> $credValue = [System.Convert]::ToBase64String($binCert);
PS C:\> New-MsolServicePrincipal -ServicePrincipalNames @("MyApp/myApp.com") -DisplayName "My Application" -Type asymmetric -Value $credValue

此示例创建服务主体。 在此示例中，服务主体使用服务主体名称 MyApp/myApp.com（显示名称 My Application）创建，并使用提供的 X509 证书myapp.cer，该证书配置了基本 64 编码的非对称密钥。

参数

-AccountEnabled

-Addresses

-AppPrincipalId

-DisplayName

-EndDate

-ServicePrincipalNames

-StartDate

-TenantId

-Type

-Usage

-Value

输出

Microsoft.Online.Administration.ServicePrincipalExtended

此 cmdlet 返回它添加的服务主体。 这包括以下信息：

• ObjectId。 服务主体的唯一标识符。
• AppPrincipalId。 服务主体的应用程序标识符。
• DisplayName。 服务主体的友好名称。
• ServicePrincipalName。 服务主体名称列表 (与服务主体关联的 SPN) 。
• TrustedForDelegation。 指示是否允许服务主体进行委派的值。
• AccountEnabled。 指示帐户是否已启用的值。

它还检索已添加的凭据列表。 每个凭据对象都包含以下信息：

• 键入 。 服务主体凭据的类型 (非对称/对称/其他) 。
• Value。 凭据的值。 如果凭据类型为 certificate，则此项表示 base64 编码证书。 如果凭据类型是对称的，则表示 AES 密钥。
• KeyGroupId。 保留供内部使用的标识符。
• KeyId。 密钥的唯一标识符。
• StartDate。 凭据使用的有效开始日期。
• EndDate。 凭据使用的有效结束日期。
• 使用情况。 指定凭据是否用于对令牌进行签名或验证。

相关链接

• Get-MsolServicePrincipal
• New-MsolServicePrincipalAddresses
• Remove-MsolServicePrincipal
• Set-MsolServicePrincipal