Crie um novo objeto temporaryAccessPassAuthenticationMethod num utilizador. Um utilizador só pode ter um Passe de Acesso Temporário que possa ser utilizado durante a duração especificada. Se o utilizador precisar de um novo Passe de Acesso Temporário enquanto o Passe de Acesso Temporário atual for válido, o administrador pode criar um novo Passe de Acesso Temporário para o utilizador, o Passe de Acesso Temporário anterior será eliminado e será criado um novo Passe de Acesso Temporário.
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.
Permissões que atuam noutros utilizadores
Tipo de permissão
Permissões com menos privilégios
Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)
UserAuthenticationMethod.ReadWrite.All
Indisponível.
Delegado (conta pessoal da Microsoft)
Sem suporte.
Sem suporte.
Application
UserAuthenticationMethod.ReadWrite.All
Indisponível.
Para cenários delegados em que um administrador aja com outro utilizador, o administrador precisa, pelo menos, da função Administrador de Autenticação ou Administrador de Autenticação PrivilegiadaMicrosoft Entra.
Solicitação HTTP
POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
Opcional. Determina se o passe está limitado a uma utilização única. Se true, o passe pode ser utilizado uma vez; se false, o passe pode ser utilizado várias vezes dentro da definição lifetimeInMinutes . Um Passe de Acesso Temporário multiuso (isUsableOnce = false), só pode ser criado e utilizado para iniciar sessão se for permitido pela política de método de autenticação Passe de Acesso Temporário.
lifetimeInMinutes
Int32
Opcional. A duração do temporaryAccessPass em minutos a partir da hora de criação ou em startDateTime, se definido. Tem de estar entre 10 e 43200 (o equivalente a 30 dias). Se não for especificado, é aplicada a predefiniçãoLifetimeInMinutes na política de método de autenticação Passe de Acesso Temporário .
startDateTime
DateTimeOffset
Opcional. A data e hora em que o temporaryAccessPass fica disponível para utilização. Se não for especificado, o Passe de Acesso Temporário está disponível para utilização imediatamente após a sua criação.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new TemporaryAccessPassAuthenticationMethod
{
StartDateTime = DateTimeOffset.Parse("2022-06-05T00:00:00.000Z"),
LifetimeInMinutes = 60,
IsUsableOnce = false,
};
// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].Authentication.TemporaryAccessPassMethods.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
"time"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.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)
// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
temporaryAccessPassMethods, err := graphClient.Users().ByUserId("user-id").Authentication().TemporaryAccessPassMethods().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TemporaryAccessPassAuthenticationMethod temporaryAccessPassAuthenticationMethod = new TemporaryAccessPassAuthenticationMethod();
OffsetDateTime startDateTime = OffsetDateTime.parse("2022-06-05T00:00:00.000Z");
temporaryAccessPassAuthenticationMethod.setStartDateTime(startDateTime);
temporaryAccessPassAuthenticationMethod.setLifetimeInMinutes(60);
temporaryAccessPassAuthenticationMethod.setIsUsableOnce(false);
TemporaryAccessPassAuthenticationMethod result = graphClient.users().byUserId("{user-id}").authentication().temporaryAccessPassMethods().post(temporaryAccessPassAuthenticationMethod);