virtualEventTownhall 资源类型

命名空间：microsoft.graph

表示有关虚拟事件市政厅的信息。

继承自 virtualEvent。

方法

方法	返回类型	Description
List	virtualEventTownhall 集合	获取在租户中创建的所有 virtualEventTownhall 对象的列表。
创建	virtualEventTownhall	创建新的 virtualEventTownhall 对象。
Get	virtualEventTownhall	读取 virtualEventTownhall 对象的属性和关系。
更新	virtualEventTownhall	更新 virtualEventTownhall 对象的属性。
发布	None	发布 virtualEventTownhall。
Cancel	None	取消 virtualEventTownhall。
按用户角色列出	virtualEventTownhall 集合	获取 virtualEventTownhall 对象的列表，其中已登录用户是组织者或协同组织者。
按用户 ID 和角色列出	virtualEventTownhall 集合	获取 虚拟EventTownhall 对象的列表，其中指定的用户是组织者或协同组织者。
设置外部事件信息	None	通过设置 externalEventId，将外部事件信息链接到 virtualEventTownhall 或 virtualEventWebinar。 ]

对 virtualEventTownhall 对象进行操作所需的角色

下表显示了可在虚拟事件大厅上执行各种操作的角色。

Role	创建	获取	更新	发布	取消
组织者	✅	✅	✅	✅	✅
共同组织者	❌	✅	✅	❌	❌
演示者	❌	✅	❌	❌	❌
Attendee	❌	✅	❌	❌	❌
自定义应用程序	❌	✅	❌	❌	❌

属性

属性	类型	说明
观众	meetingAudience	市政厅可见的观众。 可能的值为： everyone、 organization和 unknownFutureValue。
coOrganizers	communicationsUserIdentity 集合	市政厅的协组织者的身份信息。
createdBy	communicationsIdentitySet	市政厅的创建者的标识信息。 继承自 virtualEvent。 只读。
description	itemBody	市政厅的说明。 继承自 virtualEvent。
displayName	String	市政厅的显示名称。 继承自 virtualEvent。
endDateTime	dateTimeTimeZone	市政厅结束的日期和时间。 timeZone 属性可以设置为 Windows 当前支持的任何时区。 有关如何使用 PowerShell 获取所有可用时区的详细信息，请参阅 Get-TimeZone。 继承自 virtualEvent。
externalEventInformation	virtualEventExternalInformation 集合	市政厅的外部信息。 仅对活动组织者或协办者返回;否则为 null。
id	String	市政厅的唯一标识符。 继承自 entity。 只读。
invitedAttendees	identity 集合	应邀到市政厅的与会者。 支持的标识包括： communicationsUserIdentity 和 communicationsGuestIdentity。
isInviteOnly	布尔值	指示市政厅是否仅对组织内的受邀人员和组开放。 isInviteOnly 属性仅当true访问群体属性的值设置为 时，才能使用 organization。
settings	virtualEventSettings	虚拟事件设置。
startDateTime	dateTimeTimeZone	市政厅开始的日期和时间。 timeZone 属性可以设置为 Windows 当前支持的任何时区。 有关如何使用 PowerShell 获取所有可用时区的详细信息，请参阅 Get-TimeZone。 继承自 virtualEvent。
status	virtualEventStatus	市政厅的状态。 可能的值为： draft、 published、 canceled和 unknownFutureValue。 继承自 virtualEvent。

关系

关系	类型	说明
主持人	virtualEventPresenter 集合	演示者对市政厅的信息。 继承自 virtualEvent。
sessions	virtualEventSession 集合	市政厅的会议。 继承自 virtualEvent。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.virtualEventTownhall",
  "audience": "String",
  "coOrganizers": [{"@odata.type": "microsoft.graph.communicationsUserIdentity"}],
  "createdBy": {"@odata.type": "microsoft.graph.communicationsIdentitySet"},
  "description": {"@odata.type": "microsoft.graph.itemBody"},
  "displayName": "String",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "invitedAttendees": [{"@odata.type": "microsoft.graph.identity"}],
  "isInviteOnly": "Boolean",
  "settings": {"@odata.type": "microsoft.graph.virtualEventSettings"},
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "String"
}