大网数据广告活动
Microsoft Graph 接口

创建 temporaryAccessPassMethod

· 52CE 我爱测

在用户上创建新的 temporaryAccessPassAuthenticationMethod 对象。 用户只能有一个可在其指定生存期内可用的临时访问通行证。 如果用户在当前临时访问通行证有效时需要新的临时访问通行证,则管理员可以为用户创建新的临时访问通行证,删除以前的临时访问通行证,并创建新的临时访问通行证。

命名空间:microsoft.graph

在用户上创建新的 temporaryAccessPassAuthenticationMethod 对象。 用户只能有一个可在其指定生存期内可用的临时访问通行证。 如果用户在当前临时访问通行证有效时需要新的临时访问通行证,则管理员可以为用户创建新的临时访问通行证,删除以前的临时访问通行证,并创建新的临时访问通行证。

权限

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

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

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

对于管理员对另一用户执行操作的委派方案,管理员需要以下 Azure AD 角色之一:

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

HTTP 请求

POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods

请求标头

名称 说明
Authorization Bearer {token}。必需。
Content-Type application/json. Required.

请求正文

在请求正文中,提供 temporaryAccessPassAuthenticationMethod 对象的 JSON 表示形式。

下表描述了创建 temporaryAccessPassAuthenticationMethod 时可以使用的可选属性。

属性 类型 说明
isUsableOnce 布尔值 可选。 确定传递是否限制为一次性使用。 如果 true可以使用传递一次,则 false可在其生存期内多次使用该传递 InMinutes 设置。 多用临时访问传递 (isUsableOnce = false) ,只有在 临时访问传递身份验证方法策略允许的情况下,才能创建并用于登录。
lifetimeInMinutes Int32 可选。 临时AccessPass 的生存期(以分钟为单位),从创建时间开始,或者在 startDateTime(如果设置)。 必须介于 10 到 43200 (等效于 30 天) 。 如果未指定,则应用 临时访问密码身份验证方法策略中的 defaultLifetimeInMinutes 设置。
startDateTime DateTimeOffset 可选。 临时AccessPass可供使用的日期和时间。 如果未指定,则临时访问密码在创建后可立即使用。

响应

如果成功,此方法在响应正文中返回 201 Created 响应代码和 temporaryAccessPassAuthenticationMethod 对象。

示例

请求

HTTP

POST https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
Content-Type: application/json

{
    "startDateTime": "2022-06-05T00:00:00.000Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false
}

C#


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var temporaryAccessPassAuthenticationMethod = new TemporaryAccessPassAuthenticationMethod
{
    StartDateTime = DateTimeOffset.Parse("2022-06-05T00:00:00Z"),
    LifetimeInMinutes = 60,
    IsUsableOnce = false
};

await graphClient.Users["{user-id}"].Authentication.TemporaryAccessPassMethods
    .Request()
    .AddAsync(temporaryAccessPassAuthenticationMethod);

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

JavaScript


const options = {
    authProvider,
};

const client = Client.init(options);

const temporaryAccessPassAuthenticationMethod = {
    startDateTime: '2022-06-05T00:00:00.000Z',
    lifetimeInMinutes: 60,
    isUsableOnce: false
};

await client.api('/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods')
    .post(temporaryAccessPassAuthenticationMethod);

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

Java


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

TemporaryAccessPassAuthenticationMethod temporaryAccessPassAuthenticationMethod = new TemporaryAccessPassAuthenticationMethod();
temporaryAccessPassAuthenticationMethod.startDateTime = OffsetDateTimeSerializer.deserialize("2022-06-05T00:00:00Z");
temporaryAccessPassAuthenticationMethod.lifetimeInMinutes = 60;
temporaryAccessPassAuthenticationMethod.isUsableOnce = false;

graphClient.users("071cc716-8147-4397-a5ba-b2105951cc0b").authentication().temporaryAccessPassMethods()
    .buildRequest()
    .post(temporaryAccessPassAuthenticationMethod);

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

Go


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewTemporaryAccessPassAuthenticationMethod()
startDateTime, err := time.Parse(time.RFC3339, "2022-06-05T00:00:00.000Z")
requestBody.SetStartDateTime(&startDateTime)
lifetimeInMinutes := int32(60)
requestBody.SetLifetimeInMinutes(&lifetimeInMinutes)
isUsableOnce := false
requestBody.SetIsUsableOnce(&isUsableOnce)
userId := "user-id"
result, err := graphClient.UsersById(&userId).Authentication().TemporaryAccessPassMethods().Post(requestBody)


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

PowerShell


Import-Module Microsoft.Graph.Identity.SignIns

$params = @{
    StartDateTime = [System.DateTime]::Parse("2022-06-05T00:00:00.000Z")
    LifetimeInMinutes = 60
    IsUsableOnce = $false
}

New-MgUserAuthenticationTemporaryAccessPassMethod -UserId $userId -BodyParameter $params

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


响应

注意: 为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
    "id": "6f1967b7-15e8-4935-ac26-d50770ed07a7",
    "temporaryAccessPass": "+drkzqAD",
    "createdDateTime": "2022-06-02T16:21:09.765173Z",
    "startDateTime": "2022-06-05T00:00:00Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false,
    "isUsable": false,
    "methodUsabilityReason": "NotYetValid"
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 tilarso)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。