删除 phoneAuthenticationMethod

命名空间：microsoft.graph

删除用户的 电话身份验证方法。 这会删除用户的电话号码，他们将不再能够使用该号码进行身份验证，无论是通过短信还是语音呼叫。

用户不能有 alternateMobile 没有数字的数字 mobile 。 如果要从同样具有alternateMobile数字的用户中删除mobile数字，请先将mobile数字更新为新号码，然后删除该alternateMobile数字。

如果电话号码是用户的默认 Azure 多重身份验证 (MFA) 身份验证方法，则无法将其删除。 让用户更改其默认身份验证方法，然后删除该号码。

此 API 可用于以下国家级云部署。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	❌

权限

要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

针对自身操作的权限

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	UserAuthenticationMethod.ReadWrite
委派（个人 Microsoft 帐户）	不支持。
应用程序	不支持。

对其他用户进行操作的权限

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	UserAuthenticationMethod.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	UserAuthenticationMethod.ReadWrite.All

在具有工作或学校帐户的委托方案中，如果已登录用户正在对其他用户进行操作，则必须为他们分配受支持的 Microsoft Entra 角色 或具有支持的角色权限的自定义角色。 此操作支持以下最低特权角色。

• 身份验证管理员
• 特权身份验证管理员

HTTP 请求

删除自己的手机身份验证方法。

DELETE /me/authentication/phoneMethods/{phoneMethodId}

删除自己或其他用户的电话身份验证方法。

DELETE /users/{id | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}

对应于要删除的 phoneType 的值 phoneMethodId 是以下值之一：

• b6332ec1-7057-4abe-9331-3d72feddfe41 alternateMobile删除 phoneType。
• e37fc753-ff3b-4958-9484-eaa9425c82bc office删除 phoneType。
• 3179e48a-750b-4051-897c-87b9720928f7 mobile删除 phoneType。

请求标头

名称	说明
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法返回 204 No Content 响应代码。 它不会在响应正文中返回任何内容。

示例

请求

下面是请求的示例。

HTTP

DELETE https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.Authentication.PhoneMethods["{phoneAuthenticationMethod-id}"].DeleteAsync();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

CLI

mgc users authentication phone-methods delete --user-id {user-id} --phone-authentication-method-id {phoneAuthenticationMethod-id}

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Me().Authentication().PhoneMethods().ByPhoneAuthenticationMethodId("phoneAuthenticationMethod-id").Delete(context.Background(), nil)

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.me().authentication().phoneMethods().byPhoneAuthenticationMethodId("{phoneAuthenticationMethod-id}").delete();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7')
	.delete();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->me()->authentication()->phoneMethods()->byPhoneAuthenticationMethodId('phoneAuthenticationMethod-id')->delete()->wait();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

PowerShell

Import-Module Microsoft.Graph.Identity.SignIns

# A UPN can also be used as -UserId.
Remove-MgUserAuthenticationPhoneMethod -UserId $userId -PhoneAuthenticationMethodId $phoneAuthenticationMethodId

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.me.authentication.phone_methods.by_phone_authentication_method_id('phoneAuthenticationMethod-id').delete()

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

以下是响应示例。

HTTP/1.1 204 No Content