Elimine um domínio com uma operação assíncrona de execução prolongada.
Antes de efetuar esta operação, tem de atualizar ou remover quaisquer referências ao Exchange como o serviço de aprovisionamento.
As seguintes ações são executadas como parte desta operação:
Atualiza as userPrincipalNamepropriedades , maile proxyAddresses de users com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.
Atualiza a mail propriedade de groups com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.
Atualiza a identifierUris propriedade de applications com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.
Se o número de objetos cujo nome é superior a 1000, é devolvido um erro.
Se um dos nomes a mudar for uma aplicação applications multi-inquilino, é devolvido um erro.
Depois de concluída a eliminação do domínio, as operações da API para o domínio eliminado devolvem um código de estado HTTP 404. Para verificar a eliminação de um domínio, pode executar uma operação obter domínio .
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão
Permissões com menos privilégios
Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)
Domain.ReadWrite.All
Indisponível.
Delegado (conta pessoal da Microsoft)
Sem suporte.
Sem suporte.
Aplicativo
Domain.ReadWrite.All
Indisponível.
A conta escolar ou profissional tem de pertencer, pelo menos, à função Administrador de Nome de DomínioMicrosoft Entra.
Solicitação HTTP
POST /domains/{id}/forceDelete
Para {id}, especifique o domínio com seu nome de domínio totalmente qualificado.
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro
Tipo
Descrição
disableUserAccounts
Boolean
Opção para desativar as contas de utilizador cujo nome foi mudado. Se uma conta de utilizador estiver desativada, o utilizador não tem permissão para iniciar sessão. Se definido para true os utilizadores atualizados como parte desta operação, estão desativados. O valor padrão é true.
Corpo da resposta
Se for bem-sucedido, este método devolve HTTP/1.1 204 OK o código de estado.
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);
// 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)
// 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);
<?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();
# 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)