名前空間: microsoft.graph
非同期の実行時間の長い操作を使用してドメインを削除します。
この操作を実行する前に、プロビジョニング サービスとして Exchange への参照を更新または削除する必要があります。
この操作の一部として、次のアクションが実行されます。
usersのuserPrincipalName、mail、およびproxyAddressesプロパティを、削除されたドメインへの参照と共にUpdatesして、初期 onmicrosoft.com ドメインを使用します。
最初の onmicrosoft.com ドメインを使用するために、削除されたドメインへの参照を含む groups の mail プロパティをUpdatesします。
最初の onmicrosoft.com ドメインを使用するために、削除されたドメインへの参照を含む applications の identifierUris プロパティをUpdatesします。
名前を変更するオブジェクトの数が 1000 を超える場合は、エラーが返されます。
名前を変更する applications のいずれかがマルチテナント アプリの場合は、エラーが返されます。
ドメインの削除が完了すると、削除されたドメインの API 操作によって HTTP 404 状態コードが返されます。 ドメインの削除を確認するには、 ドメインの取得 操作を実行します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
✅ |
✅ |
✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
Domain.ReadWrite.All |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
Domain.ReadWrite.All |
注意事項なし。 |
重要
職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。
ドメイン名管理者 は、この操作でサポートされる最小限の特権ロールです。
HTTP 要求
POST /domains/{id}/forceDelete
{Id} には、ドメインを完全修飾ドメイン名で指定します。
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json |
要求本文
要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。
| パラメーター |
型 |
説明 |
disableUserAccounts |
Boolean |
名前が変更されたユーザー アカウントを無効にするオプション。 ユーザー アカウントが無効になっている場合、ユーザーはサインインできません。 を true に設定すると、この操作の一部として更新されたユーザーは無効になります。 既定値は、true です。 |
応答本文
成功した場合、このメソッドは状態コード HTTP/1.1 204 OK 返します。
例
要求
POST https://graph.microsoft.com/v1.0/domains/{id}/forceDelete
Content-type: application/json
{
"disableUserAccounts": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Domains.Item.ForceDelete;
var requestBody = new ForceDeletePostRequestBody
{
DisableUserAccounts = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Domains["{domain-id}"].ForceDelete.PostAsync(requestBody);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphdomains "github.com/microsoftgraph/msgraph-sdk-go/domains"
//other-imports
)
requestBody := graphdomains.NewForceDeletePostRequestBody()
disableUserAccounts := true
requestBody.SetDisableUserAccounts(&disableUserAccounts)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Domains().ByDomainId("domain-id").ForceDelete().Post(context.Background(), requestBody, nil)
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.domains.item.forcedelete.ForceDeletePostRequestBody forceDeletePostRequestBody = new com.microsoft.graph.domains.item.forcedelete.ForceDeletePostRequestBody();
forceDeletePostRequestBody.setDisableUserAccounts(true);
graphClient.domains().byDomainId("{domain-id}").forceDelete().post(forceDeletePostRequestBody);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
const forceDelete = {
disableUserAccounts: true
};
await client.api('/domains/{id}/forceDelete')
.post(forceDelete);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Domains\Item\ForceDelete\ForceDeletePostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForceDeletePostRequestBody();
$requestBody->setDisableUserAccounts(true);
$graphServiceClient->domains()->byDomainId('domain-id')->forceDelete()->post($requestBody)->wait();
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
Import-Module Microsoft.Graph.Identity.DirectoryManagement
$params = @{
disableUserAccounts = $true
}
Invoke-MgForceDomainDelete -DomainId $domainId -BodyParameter $params
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.domains.item.force_delete.force_delete_post_request_body import ForceDeletePostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ForceDeletePostRequestBody(
disable_user_accounts = True,
)
await graph_client.domains.by_domain_id('domain-id').force_delete.post(request_body)
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
応答
HTTP/1.1 204 OK