Mit dieser Aktion kann der Organisator oder Teilnehmer eines Besprechungsereignisses die Besprechungsanfrage an einen neuen Empfänger weiterleiten.
Wenn das Besprechungsereignis vom Microsoft 365-Postfach eines Teilnehmers an einen anderen Empfänger weitergeleitet wird, sendet diese Aktion auch eine Nachricht, um den Organisator über die Weiterleitung zu benachrichtigen, und fügt den Empfänger der Kopie des Besprechungsereignisses des Organisators hinzu. Diese Bequemlichkeit ist bei der Weiterleitung von einem Outlook.com-Konto nicht verfügbar.
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp
Berechtigungen mit den geringsten Berechtigungen
Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)
Calendars.Read
Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)
Calendars.Read
Nicht verfügbar.
Anwendung
Calendars.Read
Nicht verfügbar.
HTTP-Anforderung
POST /me/events/{id}/forward
POST /users/{id | userPrincipalName}/events/{id}/forward
POST /groups/{id}/events/{id}/forward
POST /me/calendar/events/{id}/forward
POST /users/{id | userPrincipalName}/calendar/events/{id}/forward
POST /groups/{id}/calendar/events/{id}/forward
POST /me/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendars/{id}/events/{id}/forward
POST /me/calendarGroups/{id}/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/forward
Anforderungsheader
Name
Typ
Beschreibung
Authorization
string
Bearer {token}. Erforderlich.
Content-Type
string
Die Art der Daten im Textkörper einer Entität. Erforderlich.
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
Parameter
Typ
Beschreibung
Kommentar
Zeichenfolge
Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein.
POST https://graph.microsoft.com/v1.0/me/events/{id}/forward
Content-type: application/json
{
"ToRecipients":[
{
"EmailAddress": {
"Address":"danas@contoso.com",
"Name":"Dana Swope"
}
}
],
"Comment": "Dana, hope you can make this meeting."
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Me.Events.Item.Forward;
using Microsoft.Graph.Models;
var requestBody = new ForwardPostRequestBody
{
ToRecipients = new List<Recipient>
{
new Recipient
{
EmailAddress = new EmailAddress
{
Address = "danas@contoso.com",
Name = "Dana Swope",
},
},
},
Comment = "Dana, hope you can make this meeting.",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.Events["{event-id}"].Forward.PostAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users events forward post --user-id {user-id} --event-id {event-id} --body '{\
"ToRecipients":[\
{\
"EmailAddress": {\
"Address":"danas@contoso.com",\
"Name":"Dana Swope"\
}\
}\
],\
"Comment": "Dana, hope you can make this meeting."\
}\
\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.users.item.events.item.forward.ForwardPostRequestBody forwardPostRequestBody = new com.microsoft.graph.users.item.events.item.forward.ForwardPostRequestBody();
LinkedList<Recipient> toRecipients = new LinkedList<Recipient>();
Recipient recipient = new Recipient();
EmailAddress emailAddress = new EmailAddress();
emailAddress.setAddress("danas@contoso.com");
emailAddress.setName("Dana Swope");
recipient.setEmailAddress(emailAddress);
toRecipients.add(recipient);
forwardPostRequestBody.setToRecipients(toRecipients);
forwardPostRequestBody.setComment("Dana, hope you can make this meeting.");
graphClient.me().events().byEventId("{event-id}").forward().post(forwardPostRequestBody);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ForwardPostRequestBody;
use Microsoft\Graph\Generated\Models\Recipient;
use Microsoft\Graph\Generated\Models\EmailAddress;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForwardPostRequestBody();
$toRecipientsRecipient1 = new Recipient();
$toRecipientsRecipient1EmailAddress = new EmailAddress();
$toRecipientsRecipient1EmailAddress->setAddress('danas@contoso.com');
$toRecipientsRecipient1EmailAddress->setName('Dana Swope');
$toRecipientsRecipient1->setEmailAddress($toRecipientsRecipient1EmailAddress);
$toRecipientsArray []= $toRecipientsRecipient1;
$requestBody->setToRecipients($toRecipientsArray);
$requestBody->setComment('Dana, hope you can make this meeting.');
$graphServiceClient->me()->events()->byEventId('event-id')->forward()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Users.Actions
$params = @{
ToRecipients = @(
@{
EmailAddress = @{
Address = "danas@contoso.com"
Name = "Dana Swope"
}
}
)
Comment = "Dana, hope you can make this meeting."
}
# A UPN can also be used as -UserId.
Invoke-MgForwardUserEvent -UserId $userId -EventId $eventId -BodyParameter $params
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.