クラウド同期ディレクトリ拡張機能とカスタム属性マッピング

識別子 URI API://<tenantId>/CloudSyncCustomExtensionsApp を持つアプリケーションが存在するかどうかを確認します。

$tenantId = (Get-MgOrganization).Id

Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')"

詳細については、「 Get-MgApplication」を参照してください。

アプリケーションが存在しない場合は、前の手順の $tenantId 変数を使用して、識別子 URI API://<tenantId>/CloudSyncCustomExtensionsAppを持つアプリケーションを作成します。

New-MgApplication -DisplayName "CloudSyncCustomExtensionsApp" -IdentifierUris "API://$tenantId/CloudSyncCustomExtensionsApp"

詳細については、「 New-MgApplication」を参照してください。

前の手順の $tenantId 変数を使用して、識別子 URI が API://<tenantId>/CloudSyncCustomExtensionsAppされたアプリケーションのサービス プリンシパルが存在するかどうかを確認します。

$appId = (Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')").AppId

Get-MgServicePrincipal -Filter "AppId eq '$appId'"

詳細については、「 Get-MgServicePrincipal」を参照してください。

サービス プリンシパルが存在しない場合は、前の手順の $tenantId 変数を使用して、識別子 URI API://<tenantId>/CloudSyncCustomExtensionsAppを持つアプリケーションの新しいサービス プリンシパルを作成します。

New-MgServicePrincipal -AppId $appId

詳細については、「 New-MgServicePrincipal」を参照してください。

前の手順の $tenantId 変数を使用して、Microsoft Entra ID でディレクトリ拡張機能を作成します。 たとえば、Group オブジェクトの文字列型の "GroupDN" という名前の新しい拡張機能を次に示します。

$appObjId = (Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')").Id

New-MgApplicationExtensionProperty -ApplicationId $appObjId -Name GroupDN -DataType String -TargetObjects Group

識別子 URI API://<tenantId>/CloudSyncCustomExtensionsApp を持つアプリケーションが存在するかどうかを確認します。

GET /applications?$filter=identifierUris/any(uri:uri eq 'api://<tenantId>/CloudSyncCustomExtensionsApp')

詳細については、「アプリケーションを取得する」を参照してください

アプリケーションが存在しない場合は、識別子 URI API://<tenantId>/CloudSyncCustomExtensionsAppを使用してアプリケーションを作成します。

POST https://graph.microsoft.com/v1.0/applications
Content-type: application/json

{
"displayName": "CloudSyncCustomExtensionsApp",
"identifierUris": ["api://<tenant id>/CloudSyncCustomExtensionsApp"]
}

詳細については、「アプリケーションの 作成」を参照してください。

識別子 URI が API://<tenantId>/CloudSyncCustomExtensionsAppされたアプリケーションのサービス プリンシパルが存在するかどうかを確認します。

GET /servicePrincipals?$filter=(appId eq '{appId}')

詳細については、「servicePrincipal を取得する」を参照してください

サービス プリンシパルが存在しない場合は、識別子 URI API://<tenantId>/CloudSyncCustomExtensionsAppを持つアプリケーションの新しいサービス プリンシパルを作成します。

POST https://graph.microsoft.com/v1.0/servicePrincipals
Content-type: application/json

{
"appId": 
"<application appId>"
}

詳細については、「 servicePrincipal の作成」を参照してください。

Microsoft Entra ID でディレクトリ拡張機能を作成します。 たとえば、Group オブジェクトの文字列型の "GroupDN" という名前の新しい拡張機能を次に示します。

POST https://graph.microsoft.com/v1.0/applications/<ApplicationId>/extensionProperties
Content-type: application/json

{
  "name": "GroupDN",
  "dataType": "String",
  "isMultiValued": false,
  "targetObjects": [
      "Group"
  ]
}