New-MsolServicePrincipalCredential

構文

New-MsolServicePrincipalCredential
   -ObjectId <Guid>
   [-Type <ServicePrincipalCredentialType>]
   [-Value <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Usage <ServicePrincipalCredentialUsage>]
   [-TenantId <Guid>]
   [<CommonParameters>]

New-MsolServicePrincipalCredential
   -ServicePrincipalName <String>
   [-Type <ServicePrincipalCredentialType>]
   [-Value <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Usage <ServicePrincipalCredentialUsage>]
   [-TenantId <Guid>]
   [<CommonParameters>]

New-MsolServicePrincipalCredential
   -AppPrincipalId <Guid>
   [-Type <ServicePrincipalCredentialType>]
   [-Value <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Usage <ServicePrincipalCredentialUsage>]
   [-TenantId <Guid>]
   [<CommonParameters>]

説明

New-MsolServicePrincipalCredential コマンドレットは、サービス プリンシパルに新しい資格情報を追加するか、アプリケーションの資格情報キーを追加またはロールします。 サービス プリンシパルは、オブジェクト ID、アプリ プリンシパル ID、またはサービス プリンシパル名 (SPN) を指定することによって識別されます。

例

例 1: サービス プリンシパルに既存の資格情報を追加する

PS C:\> $Certificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate
PS C:\> $Certificate.Import("C:\myapp.cer")
PS C:\> $BinCert = $Certificate.GetRawCertData()
PS C:\> $CredValue = [System.Convert]::ToBase64String($binCert);
PS C:\> New-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com" -Type asymmetric -Value $CredValue -StartDate $Certificate.GetEffectiveDateString() -EndDate $Certificate.GetExpirationDateString()

次の使用例は、資格情報 (キー) オブジェクトを既存のサービス プリンシパルに追加します。 この例では、指定された base64 でエンコードされたパブリック X509 証明書 (myapp.cer という名前) が、MyApp/myApp.com のサービス プリンシパル名の値を使用してサービス プリンシパルに追加されます。

例 2: オンプレミスのExchange Serverを登録する

PS C:\> New-MsolServicePrincipalCredential -AppPrincipalId  -Type asymmetric -Value $CredValue

このコマンドは、オンプレミスのExchange Serverを登録して、Exchange ServerとOffice 365などのMicrosoft Azure Active Directoryサービス間の通信が行われるようにします。 この例では、$credValue に含まれる base64 エンコードされた公開 X509 証明書を使用して、オンプレミスの Exchange Server を表します。 Office 365 サーバーの既知の ID は次のとおりです。

• Exchange: 00000002-0000-0ff1-ce00-00000000000
• SharePoint: 00000003-0000-0ff1-ce00-00000000000
• Lync: 00000004-0000-0ff1-ce00-000000000000

パラメーター

-AppPrincipalId

-EndDate

-ObjectId

-ServicePrincipalName

-StartDate

-TenantId

-Type

-Usage

-Value

関連リンク

• Get-MsolServicePrincipalCredential
• Remove-MsolServicePrincipalCredential