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 コマンドレットは、基幹業務 (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 と表示名 My Application を使用してサービス プリンシパルが作成され、自動生成された 256 ビット対称キーを使用してアプリケーションを検証します。 このキーは、当日から 1 年間有効です。

例 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 を使用して作成され、base 64 でエンコードされた非対称キーで構成された指定された X509 証明書myapp.cerを使用します。

パラメーター

-AccountEnabled

-Addresses

-AppPrincipalId

-DisplayName

-EndDate

-ServicePrincipalNames

-StartDate

-TenantId

-Type

-Usage

-Value

出力

Microsoft.Online.Administration.ServicePrincipalExtended

このコマンドレットは、追加したサービス プリンシパルを返します。 これには、次の情報が含まれます。

• Objectid。 サービス プリンシパルの一意識別子。
• AppPrincipalId。 サービス プリンシパルのアプリケーション識別子。
• DisplayName。 サービス プリンシパルのフレンドリ名。
• ServicePrincipalName。 サービス プリンシパルに関連付けられているサービス プリンシパル名 (SPN) の一覧。
• TrustedForDelegation。 サービス プリンシパルが委任に許可されているかどうかを示す値。
• AccountEnabled。 アカウントが有効かどうかを示す値。

また、追加された資格情報の一覧も取得します。 各資格情報オブジェクトには、次の情報が含まれています。

• [Type](種類)。 サービス プリンシパル資格情報の種類 (非対称/対称/その他)。
• Value。 資格情報の値。 資格情報の種類が証明書の場合、これは Base 64 エンコード証明書を表します。 資格情報の種類が対称の場合は、AES キーを表します。
• KeyGroupId。 内部使用のために予約されている識別子。
• KeyId。 キーの一意識別子。
• Startdate。 資格情報の使用の有効な開始日。
• Enddate。 資格情報の使用の有効な終了日。
• 利用状況。 資格情報を使用してトークンの署名または検証を行うかどうかを指定します。

関連リンク

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