Tipo de recurso virtualEventTownhall

Artículo
01/10/2025

Espacio de nombres: microsoft.graph

Representa información sobre un ayuntamiento de eventos virtual.

Métodos

Método	Tipo devuelto	Descripción
List	Colección virtualEventTownhall	Obtenga la lista de todos los objetos virtualEventTownhall creados en un inquilino.
Crear	virtualEventTownhall	Cree un nuevo objeto virtualEventTownhall .
Get	virtualEventTownhall	Lea las propiedades y relaciones de un objeto virtualEventTownhall .
Actualizar	virtualEventTownhall	Actualice las propiedades de un objeto virtualEventTownhall .
Publicar	Ninguno	Publique un objeto virtualEventTownhall.
Cancel	Ninguno	Cancela una instancia de virtualEventTownhall.
Lista por rol de usuario	Colección virtualEventTownhall	Obtenga una lista de objetos virtualEventTownhall donde el usuario que ha iniciado sesión sea el organizador o un coorganizador.
Lista por identificador de usuario y rol	Colección virtualEventTownhall	Obtenga una lista de objetos virtualEventTownhall donde el usuario especificado sea el organizador o un coorganizador.
Establecimiento de información de eventos externos	Ninguno	Vincule la información de eventos externos a virtualEventTownhall o virtualEventWebinar estableciendo un externalEventId. ]

Roles necesarios para actuar en objetos virtualEventTownhall

En la tabla siguiente se muestran los roles que pueden realizar varias acciones en los ayuntamientos de eventos virtuales.

Role	Crear	Obtener	Actualizar	Publicar	Cancelar
Organizador	✅	✅	✅	✅	✅
Coorganizador	❌	✅	✅	❌	❌
Presentador	❌	✅	❌	❌	❌
Asistente	❌	✅	❌	❌	❌
Aplicación personalizada	❌	✅	❌	❌	❌

Propiedades

Propiedad	Tipo	Descripción
audiencia	meetingAudience	El público al que está visible el ayuntamiento. Los valores posibles son: `everyone`, `organization`y `unknownFutureValue`.
coOrganizers	communicationsUserIdentity (colección)	Información de identidad de los coorganizadores del ayuntamiento.
createdBy	communicationsIdentitySet	Información de identidad del creador del ayuntamiento. Se hereda de virtualEvent. Solo lectura.
description	itemBody	Descripción del ayuntamiento. Se hereda de virtualEvent.
displayName	Cadena	Nombre para mostrar del ayuntamiento. Se hereda de virtualEvent.
endDateTime	dateTimeTimeZone	Fecha y hora en que finaliza el ayuntamiento. La propiedad timeZone se puede establecer en cualquiera de las zonas horarias admitidas actualmente por Windows. Para obtener más información sobre cómo obtener todas las zonas horarias disponibles mediante PowerShell, consulte Get-TimeZone. Se hereda de virtualEvent.
externalEventInformation	Colección virtualEventExternalInformation	La información externa de un ayuntamiento. Solo se devuelve para organizadores de eventos o coorganizadores; De lo contrario, `null`.
id	Cadena	Identificador único del ayuntamiento. Heredado de la entidad. Solo lectura.
invitedAttendees	colección de identidades	Los asistentes invitaron al ayuntamiento. Las identidades admitidas son: communicationsUserIdentity y communicationsGuestIdentity.
isInviteOnly	Booleano	Indica si el ayuntamiento solo está abierto a personas y grupos invitados dentro de su organización. La propiedad isInviteOnly solo puede ser `true` si el valor de la propiedad audience está establecido en `organization`.
configuración	virtualEventSettings	Configuración de eventos virtuales.
startDateTime	dateTimeTimeZone	Fecha y hora en que comienza el ayuntamiento. La propiedad timeZone se puede establecer en cualquiera de las zonas horarias admitidas actualmente por Windows. Para obtener más información sobre cómo obtener todas las zonas horarias disponibles mediante PowerShell, consulte Get-TimeZone. Se hereda de virtualEvent.
status	virtualEventStatus	Estado del ayuntamiento. Los valores posibles son `draft`, `published`, `canceled` y `unknownFutureValue` Se hereda de virtualEvent.

Relaciones

Relación	Tipo	Descripción
Presentadores	colección virtualEventPresenter	Información de los presentadores del ayuntamiento. Se hereda de virtualEvent.
Sesiones	Colección virtualEventSession	Sesiones del ayuntamiento. Se hereda de virtualEvent.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@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"
}

Compartir vía