更新 temporaryAccessPassAuthenticationMethodConfiguration
本文内容
命名空间:microsoft.graph
更新由 temporaryAccessPassAuthenticationMethodConfiguration 对象表示的 Azure AD 租户的临时访问传递策略。
权限
调用此 API 需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限 。
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
Policy.ReadWrite.AuthenticationMethod
委派(个人 Microsoft 帐户)
不支持。
应用程序
Policy.ReadWrite.AuthenticationMethod
对于委托方案,管理员需要 身份验证策略管理员 Azure AD 角色 。
HTTP 请求
PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
名称
说明
Authorization
持有者 {token}。 必填。
Content-Type
application/json. 必需。
请求正文
在请求正文中,提供 temporaryAccessPassAuthenticationMethodConfiguration 对象的 JSON 表示形式,其中包含应更新的字段的值。 请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。 为了获得最佳性能,请勿加入尚未更改的现有值。
对象的所有属性和关系都可以更新。 有关属性和关系的列表,请参阅 temporaryAccessPassAuthenticationMethodConfiguration 。
注意
值为 #microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration
的 @odata.type 属性必须包含在请求正文中。
响应
如果成功,此方法返回 204 No Content
响应代码。 它不会在响应正文中返回任何内容。
示例
请求
PATCH https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass
Content-Type: application/json
{
"@odata.type":"#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
"isUsableOnce": true
}
var graphClient = new GraphServiceClient(requestAdapter);
var requestBody = new AuthenticationMethodConfiguration
{
OdataType = "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
AdditionalData = new Dictionary<string, object>
{
{
"isUsableOnce" , true
},
},
};
var result = await graphClient.Policies.AuthenticationMethodsPolicy.AuthenticationMethodConfigurations["{authenticationMethodConfiguration-id}"].PatchAsync(requestBody);
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
const options = {
authProvider,
};
const client = Client.init(options);
const authenticationMethodConfiguration = {
'@odata.type':'#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration',
isUsableOnce: true
};
await client.api('/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass')
.update(authenticationMethodConfiguration);
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
TemporaryAccessPassAuthenticationMethodConfiguration authenticationMethodConfiguration = new TemporaryAccessPassAuthenticationMethodConfiguration();
authenticationMethodConfiguration.isUsableOnce = true;
graphClient.policies().authenticationMethodsPolicy().authenticationMethodConfigurations("temporaryAccessPass")
.buildRequest()
.patch(authenticationMethodConfiguration);
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewAuthenticationMethodConfiguration()
additionalData := map[string]interface{}{
isUsableOnce := true
requestBody.SetIsUsableOnce(&isUsableOnce)
}
requestBody.SetAdditionalData(additionalData)
result, err := graphClient.Policies().AuthenticationMethodsPolicy().AuthenticationMethodConfigurationsById("authenticationMethodConfiguration-id").Patch(context.Background(), requestBody, nil)
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
Import-Module Microsoft.Graph.Identity.SignIns
$params = @{
"@odata.type" = "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration"
IsUsableOnce = $true
}
Update-MgPolicyAuthenticationMethodPolicyAuthenticationMethodConfiguration -AuthenticationMethodConfigurationId $authenticationMethodConfigurationId -BodyParameter $params
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
<?php
// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);
$requestBody = new AuthenticationMethodConfiguration();
$requestBody->set@odatatype('#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration');
$additionalData = [
'isUsableOnce' => true,
];
$requestBody->setAdditionalData($additionalData);
$requestResult = $graphServiceClient->policies()->authenticationMethodsPolicy()->authenticationMethodConfigurationsById('authenticationMethodConfiguration-id')->patch($requestBody);
有关如何 将 SDK 添加到 项目并 创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
响应
HTTP/1.1 204 No Content