Aktualisieren von onlineMeeting

Artikel
02/27/2025

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften des angegebenen onlineMeeting-Objekts .

Eine Liste der Eigenschaften, die das Aktualisieren unterstützen, finden Sie im Abschnitt Anforderungstext .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	❌

Berechtigungen

In den folgenden Tabellen sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungen für die folgende HTTP-Anforderung:

PATCH /me/onlineMeetings/{meetingId}

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	OnlineMeetings.ReadWrite	Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	Nicht unterstützt	Nicht unterstützt

Berechtigungen für die folgende HTTP-Anforderung:

PATCH /users/{userId}/onlineMeetings/{meetingId}

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	OnlineMeetings.ReadWrite	Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	OnlineMeetings.ReadWrite.All	Nicht verfügbar.

Hinweis

Um die Anwendungsberechtigung für diese API zu verwenden, müssen Mandantenadministratoren eine Anwendungszugriffsrichtlinie erstellen und sie einem Benutzer erteilen, um die in der Richtlinie konfigurierte App für die Aktualisierung von Onlinebesprechungen im Namen dieses Benutzers zu autorisieren (mit benutzer-ID, die im Anforderungspfad angegeben ist).

HTTP-Anforderung

So aktualisieren Sie das angegebene onlineMeeting mithilfe der Besprechungs-ID mit delegierter (/me) und app-Berechtigung (/users/{userId}/)

PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}

Hinweis

userIdist die Objekt-ID eines Benutzers auf der Seite Microsoft Entra Admin Center > Benutzerverwaltung. Weitere Informationen finden Sie unter Anwendungszugriffsrichtlinie.
meetingId ist die ID eines onlineMeeting-Objekts .

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-type	application/json. Erforderlich.

Anforderungstext

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die aktualisiert werden können. Geben Sie im Anforderungstext nur die Werte für Eigenschaften an, die aktualisiert werden sollen, mit den folgenden Ausnahmen:

Das Anpassen des Start- oder Enddatums/der Endzeit einer Onlinebesprechung erfordert immer sowohl die Eigenschaften startDateTime als auch endDateTime im Anforderungstext.
Das Organisatorfeld der Eigenschaft teilnehmer kann nicht aktualisiert werden. Der Organisator der Besprechung kann nach dem Erstellen der Besprechung nicht mehr geändert werden.
Das Anpassen des Teilnehmerfelds der Teilnehmereigenschaft , z. B. das Hinzufügen oder Entfernen eines Teilnehmers zur Besprechung, erfordert immer die vollständige Liste der Teilnehmer im Anforderungstext.

Die letzte Spalte gibt an, ob die Aktualisierung dieser Eigenschaft für eine laufende Besprechung wirksam wird.

Eigenschaft	Typ	Beschreibung	Gilt für laufende Besprechungen?
allowAttendeeToEnableCamera	Boolesch	Gibt an, ob Teilnehmer ihre Kamera einschalten können.	Ja
allowAttendeeToEnableMic	Boolesch	Gibt an, ob Teilnehmer ihr Mikrofon einschalten können.	Ja
allowBreakoutRooms	Boolesch	Gibt an, ob Gruppenräume für die Besprechung aktiviert sind.	Nein
allowedLobbyAdmitters	allowedLobbyAdmitterRoles	Gibt die Benutzer an, die über den Wartebereich zugelassen werden können. Mögliche Werte sind: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers` und `unknownFutureValue`.	Ja
allowedPresenters	onlineMeetingPresenters	Gibt an, wer Referent in einer Besprechung sein kann.	Ja
allowLiveShare	meetingLiveShareOptions	Gibt an, ob live share für die Besprechung aktiviert ist.	Nein
allowMeetingChat	meetingChatMode	Gibt den Modus des Besprechungschats an.	Ja
allowPowerPointSharing	Boolesch	Gibt an, ob PowerPoint Live für die Besprechung aktiviert ist.	Nein
allowRecording	Boolesch	Gibt an, ob die Aufzeichnung für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase.	Ja
allowTeamworkReactions	Boolesch	Gibt an, ob Teams-Reaktionen für die Besprechung aktiviert sind.	Ja
allowTranscription	Boolesch	Gibt an, ob die Transkription für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase.	Ja
allowWhiteboard	Boolesch	Gibt an, ob whiteboard für die Besprechung aktiviert ist.	Nein
anonymizeIdentityForRoles	onlineMeetingRole-Sammlung	Gibt an, wessen Identität in der Besprechung anonymisiert wird. Mögliche Werte sind: `attendee`. Der `attendee` Wert kann nach dem Hinzufügen nicht über einen PATCH-Vorgang entfernt werden. Geerbt von onlineMeetingBase.	Nein
endDateTime	DateTime	Die Endzeit der Besprechung in UTC.	Nein
isEntryExitAnnounced	Boolesch	Gibt an, ob angekündigt werden soll, wann Anrufer beitreten oder diese verlassen.	Ja
lobbyBypassSettings	lobbyBypassSettings	Gibt an, welche Teilnehmer den Besprechungslobby umgehen können.	Ja
participants	meetingParticipants	Die Teilnehmer, die der Onlinebesprechung zugeordnet sind. Nur Teilnehmer können aktualisiert werden.	Nein
recordAutomatisch	Boolesch	Gibt an, ob die Besprechung automatisch erfasst werden soll.	Nein
startDateTime	DateTime	Die Startzeit der Besprechung in UTC.	Nein
subject	Zeichenfolge	Das Thema der Onlinebesprechung.	Nein
watermarkProtection	watermarkProtectionValues	Gibt an, ob die Clientanwendung ein Wasserzeichen auf einen Inhaltstyp anwenden soll. Geerbt von onlineMeetingBase. Geerbt von onlineMeetingBase.	Nein
broadcastSettings (veraltet)	broadcastMeetingSettings	Einstellungen im Zusammenhang mit einem Liveereignis.	Nein

Hinweis

Eine Liste der möglichen Werte für allowedPresenters, allowLiveShare und allowMeetingChat finden Sie unter onlineMeeting.
Wenn Sie den Wert von allowedPresenters auf roleIsPresenteraktualisieren, fügen Sie im Anforderungstext eine vollständige Liste von Teilnehmern ein, deren Rolle auf presenter festgelegt ist.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes onlineMeeting-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren von startDateTime, endDateTime und subject

Anforderung

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "startDateTime": "2020-09-09T14:33:30.8546353-07:00",
  "endDateTime": "2020-09-09T15:03:30.8566356-07:00",
  "subject": "Patch Meeting Subject"
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new OnlineMeeting
{
	StartDateTime = DateTimeOffset.Parse("2020-09-09T14:33:30.8546353-07:00"),
	EndDateTime = DateTimeOffset.Parse("2020-09-09T15:03:30.8566356-07:00"),
	Subject = "Patch Meeting Subject",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.OnlineMeetings["{onlineMeeting-id}"].PatchAsync(requestBody);



mgc users online-meetings patch --user-id {user-id} --online-meeting-id {onlineMeeting-id} --body '{\
  "startDateTime": "2020-09-09T14:33:30.8546353-07:00",\
  "endDateTime": "2020-09-09T15:03:30.8566356-07:00",\
  "subject": "Patch Meeting Subject"\
}\
'



// 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.NewOnlineMeeting()
startDateTime , err := time.Parse(time.RFC3339, "2020-09-09T14:33:30.8546353-07:00")
requestBody.SetStartDateTime(&startDateTime) 
endDateTime , err := time.Parse(time.RFC3339, "2020-09-09T15:03:30.8566356-07:00")
requestBody.SetEndDateTime(&endDateTime) 
subject := "Patch Meeting Subject"
requestBody.SetSubject(&subject) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
onlineMeetings, err := graphClient.Me().OnlineMeetings().ByOnlineMeetingId("onlineMeeting-id").Patch(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

OnlineMeeting onlineMeeting = new OnlineMeeting();
OffsetDateTime startDateTime = OffsetDateTime.parse("2020-09-09T14:33:30.8546353-07:00");
onlineMeeting.setStartDateTime(startDateTime);
OffsetDateTime endDateTime = OffsetDateTime.parse("2020-09-09T15:03:30.8566356-07:00");
onlineMeeting.setEndDateTime(endDateTime);
onlineMeeting.setSubject("Patch Meeting Subject");
OnlineMeeting result = graphClient.me().onlineMeetings().byOnlineMeetingId("{onlineMeeting-id}").patch(onlineMeeting);


const options = {
	authProvider,
};

const client = Client.init(options);

const onlineMeeting = {
  startDateTime: '2020-09-09T14:33:30.8546353-07:00',
  endDateTime: '2020-09-09T15:03:30.8566356-07:00',
  subject: 'Patch Meeting Subject'
};

await client.api('/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi')
	.update(onlineMeeting);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\OnlineMeeting;


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

$requestBody = new OnlineMeeting();
$requestBody->setStartDateTime(new \DateTime('2020-09-09T14:33:30.8546353-07:00'));
$requestBody->setEndDateTime(new \DateTime('2020-09-09T15:03:30.8566356-07:00'));
$requestBody->setSubject('Patch Meeting Subject');

$result = $graphServiceClient->me()->onlineMeetings()->byOnlineMeetingId('onlineMeeting-id')->patch($requestBody)->wait();


Import-Module Microsoft.Graph.CloudCommunications

$params = @{
	startDateTime = [System.DateTime]::Parse("2020-09-09T14:33:30.8546353-07:00")
	endDateTime = [System.DateTime]::Parse("2020-09-09T15:03:30.8566356-07:00")
	subject = "Patch Meeting Subject"
}

# A UPN can also be used as -UserId.
Update-MgUserOnlineMeeting -UserId $userId -OnlineMeetingId $onlineMeetingId -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.online_meeting import OnlineMeeting
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = OnlineMeeting(
	start_date_time = "2020-09-09T14:33:30.8546353-07:00",
	end_date_time = "2020-09-09T15:03:30.8566356-07:00",
	subject = "Patch Meeting Subject",
)

result = await graph_client.me.online_meetings.by_online_meeting_id('onlineMeeting-id').patch(request_body)

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
   "id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
   "creationDateTime":"2020-07-03T00:23:39.444642Z",
   "startDateTime":"2020-09-09T21:33:30.8546353Z",
   "endDateTime":"2020-09-09T22:03:30.8566356Z",
   "joinWebUrl":"url",
   "subject":"Patch Meeting Subject",
   "isBroadcast":false,
   "autoAdmittedUsers":"EveryoneInCompany",
   "outerMeetingAutoAdmittedUsers":null,
   "participants":{
      "organizer":{
         "upn":"upn",
         "role": "presenter",
         "identity":{
            "azureApplicationInstance":null,
            "applicationInstance":null,
            "application":null,
            "device":null,
            "user":{
               "id":"8716745d-77a9-4be3-afff-009e4b81658e",
               "displayName":null,
               "tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
               "identityProvider":"AAD"
            }
         }
      }
   },
   "audioConferencing":{
      "conferenceId":"id",
      "tollNumber":"+1-900-555-0100",
      "tollFreeNumber":"+1-800-555-0100",
      "dialinUrl":"url"
   }
}

Beispiel 2: Aktualisieren von lobbyBypassSettings

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "lobbyBypassSettings": {
      "isDialInBypassEnabled": true
  }
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new OnlineMeeting
{
	LobbyBypassSettings = new LobbyBypassSettings
	{
		IsDialInBypassEnabled = true,
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.OnlineMeetings["{onlineMeeting-id}"].PatchAsync(requestBody);



mgc users online-meetings patch --user-id {user-id} --online-meeting-id {onlineMeeting-id} --body '{\
  "lobbyBypassSettings": {\
      "isDialInBypassEnabled": true\
  }\
}\
'



// 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"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewOnlineMeeting()
lobbyBypassSettings := graphmodels.NewLobbyBypassSettings()
isDialInBypassEnabled := true
lobbyBypassSettings.SetIsDialInBypassEnabled(&isDialInBypassEnabled) 
requestBody.SetLobbyBypassSettings(lobbyBypassSettings)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
onlineMeetings, err := graphClient.Me().OnlineMeetings().ByOnlineMeetingId("onlineMeeting-id").Patch(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

OnlineMeeting onlineMeeting = new OnlineMeeting();
LobbyBypassSettings lobbyBypassSettings = new LobbyBypassSettings();
lobbyBypassSettings.setIsDialInBypassEnabled(true);
onlineMeeting.setLobbyBypassSettings(lobbyBypassSettings);
OnlineMeeting result = graphClient.me().onlineMeetings().byOnlineMeetingId("{onlineMeeting-id}").patch(onlineMeeting);


const options = {
	authProvider,
};

const client = Client.init(options);

const onlineMeeting = {
  lobbyBypassSettings: {
      isDialInBypassEnabled: true
  }
};

await client.api('/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi')
	.update(onlineMeeting);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\OnlineMeeting;
use Microsoft\Graph\Generated\Models\LobbyBypassSettings;


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

$requestBody = new OnlineMeeting();
$lobbyBypassSettings = new LobbyBypassSettings();
$lobbyBypassSettings->setIsDialInBypassEnabled(true);
$requestBody->setLobbyBypassSettings($lobbyBypassSettings);

$result = $graphServiceClient->me()->onlineMeetings()->byOnlineMeetingId('onlineMeeting-id')->patch($requestBody)->wait();


Import-Module Microsoft.Graph.CloudCommunications

$params = @{
	lobbyBypassSettings = @{
		isDialInBypassEnabled = $true
	}
}

# A UPN can also be used as -UserId.
Update-MgUserOnlineMeeting -UserId $userId -OnlineMeetingId $onlineMeetingId -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.online_meeting import OnlineMeeting
from msgraph.generated.models.lobby_bypass_settings import LobbyBypassSettings
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = OnlineMeeting(
	lobby_bypass_settings = LobbyBypassSettings(
		is_dial_in_bypass_enabled = True,
	),
)

result = await graph_client.me.online_meetings.by_online_meeting_id('onlineMeeting-id').patch(request_body)

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
    "creationDateTime":"2020-07-03T00:23:39.444642Z",
    "startDateTime":"2020-09-09T21:33:30.8546353Z",
    "endDateTime":"2020-09-09T22:03:30.8566356Z",
    "joinWebUrl":"(redacted)",
    "subject":"Patch Meeting Subject",
    "autoAdmittedUsers": "EveryoneInCompany",
    "isEntryExitAnnounced": true,
    "allowedPresenters": "everyone",
    "videoTeleconferenceId": "(redacted)",
    "participants": {
        "organizer": {
            "upn": "(redacted)",
            "role": "presenter",
            "identity": {
                "user": {
                    "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
                    "displayName": null,
                    "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
                    "identityProvider": "AAD"
                }
            }
        },
        "attendees": [],
    },
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}

Freigeben über

Aktualisieren von onlineMeeting

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Aktualisieren von startDateTime, endDateTime und subject

Anforderung

Antwort

Beispiel 2: Aktualisieren von lobbyBypassSettings

Antwort

Feedback

Zusätzliche Ressourcen