Set-PlaceV3

Use el cmdlet Set-PlaceV3 para actualizar metadatos sobre escritorios, salas, áreas de trabajo, secciones, pisos o edificios dentro del directorio de Places.

Sintaxis

Creación

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

Floor

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

Sección

Una sección es una agrupación de espacios dentro de un piso, por ejemplo, un vecindario. Los escritorios y áreas de trabajo deben ser padres a una sección. Las habitaciones también se pueden vincular opcionalmente a una sección o se pueden vincular directamente a un piso.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]

Escritorio

Los escritorios son un tipo de entidad recientemente introducido en Microsoft Places, que representa unidades de escritorio individuales. Cada escritorio incluye una propiedad Mode que especifica cómo se puede reservar el escritorio. Para obtener más información, consulte la sección modo a continuación.

En el caso de los escritorios, existen las siguientes dependencias entre el modo y la configuración del buzón:

• Si la propiedad Modo no está definida, el escritorio se muestra de forma predeterminada No disponible y no se crea ningún buzón de escritorio automáticamente.
• Para los escritorios establecidos en modo reservable o DropIn, se requiere un buzón de escritorio. Uno se crea automáticamente cuando se aprovisiona el escritorio. Como alternativa, puede vincular un buzón existente especificando EmailAddress en el parámetro Mailbox.
• Para los escritorios en modo Asignado o No disponible, la vinculación de un buzón es opcional y no se crea ningún buzón de forma predeterminada. Sin embargo, puede asociar manualmente estos escritorios con buzones personalizados si es necesario.
• Si no se configura ningún modo inicialmente, el escritorio permanece en modo No disponible. Vincular un buzón después no actualiza automáticamente el modo del escritorio.

A diferencia de los tipos de sala o área de trabajo, los escritorios no se aprovisionan automáticamente simplemente creando un buzón. Además, los metadatos como Capacity o DisplayName no se sincronizan con las propiedades del buzón. El motor de reservas utiliza principalmente el buzón, mientras que los metadatos se leen desde el directorio de Places.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

Sala

Set-PlaceV3 admite parámetros de ubicación heredados que ya están disponibles en el cmdlet de Exchange Set-Place. Sin embargo, una vez que una sala está vinculada a un piso o edificio mediante el parámetro, los -ParentId detalles de ubicación (Street y City) deben administrarse en el nivel de edificio, no en la sala o área de trabajo individual.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

Área de trabajo

Set-PlaceV3 admite parámetros de ubicación heredados que ya están disponibles en el cmdlet de Exchange Set-Place. Sin embargo, una vez que un área de trabajo está vinculada a una sección mediante el parámetro, los detalles de -ParentId ubicación (Street y City) deben administrarse en el nivel del edificio, no en la sala o área de trabajo individual.

El área de trabajo admite la propiedad Modo. Los detalles de los mismos se documentan en -Mode la sección de parámetros.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

Description

Places depende de una jerarquía totalmente configurada entre las salas o áreas de trabajo, las plantas y los edificios. Una vez creados los edificios y las plantas, puede vincularlos mediante parentId. Una habitación debe tener un piso o sección principal. Un área de trabajo o un escritorio deben tener una sección principal. Una sección debe tener un piso principal. Una planta debe tener un edificio principal.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Debe tener el rol de Administración de Exchange o el rol TenantPlacesManagement de Places.

Ejemplos

Ejemplo 1

En este ejemplo se configura la jerarquía de directorios para una sala, un piso y un edificio.

En este ejemplo, el PlaceId del piso es f12172b6-195d-4e6e-8f4f-eb72e41de99a y el PlaceId del edificio es daa2f89b-75c4-4eb7-adcc-ff249233338d.

Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d

Ejemplo 2

En este ejemplo se actualiza la dirección de un edificio.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

Ejemplo 3

En este ejemplo se actualizan las coordenadas geográficas de un edificio.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"

Ejemplo 4

En este ejemplo se actualizan los vínculos de recursos de un edificio con vínculos de recursos. Todo el conjunto se reemplaza en la actualización. Para agregar o quitar un valor, asegúrese de incluir valores anteriores que se deban conservar.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

Ejemplo 5

En este ejemplo se crea un escritorio reservable en una sección sin especificar los detalles del buzón. Se crea y vincula automáticamente un buzón de escritorio, y se rellena la propiedad MailboxOID. El mostrador aparece en el Buscador de Places y está disponible para que cualquier persona lo reserve.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'}

Ejemplo 6

En este ejemplo se actualiza el valor de mode a modo DropIn.

Set-PlaceV3 -Identity <DeskOrWorkspacePlaceId> -Mode @{Name='DropIn'}

Ejemplo 7

En este ejemplo se actualiza el valor de modo a modo asignado.

Tenga en cuenta que incluso si el escritorio ya es un escritorio de modo asignado, el cambio es solo el campo de metadatos. Es necesario crear un objeto de modo completamente nuevo y reemplazar el anterior.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity <DeskPlaceId> -Mode @{Name='Assigned';Metadata=$modemetadata}

Parameters

-Identidad

El parámetro identity especifica el lugar en el que desea realizar la actualización. Puedes usar cualquier valor que identifique un lugar de forma única.

Por ejemplo, para lugares basados en un buzón (salas de conferencias y áreas de trabajo):

• Nombre [en desuso]
• Alias [en desuso]
• Nombre distintivo (DN) [en desuso]
• DN canónico [en desuso]
• GUID [en desuso]
• Dirección de correo electrónico

Por ejemplo, para lugares que no se basan en un buzón (edificios, plantas, secciones y escritorios):

• Nombre
• GUID

-AudioDeviceName y -VideoDeviceName

Estos parámetros especifican el nombre de los dispositivos de audio y vídeo de la sala. Si el valor contiene espacios, escriba el valor entre comillas (").

El valor predeterminado está en blanco ($null). Para indicar que esta sala no tiene ningún dispositivo de audio o vídeo, use el valor $null del parámetro.

-Construcción

El parámetro Building especifica el nombre del edificio o el número de edificio en el que se encuentra la habitación. Si el valor contiene espacios, escriba el valor entre comillas (").

-Capacidad

El parámetro Capacidad especifica la capacidad de la sala o área de trabajo. Un valor válido es un entero.

-Ciudad

El parámetro Ciudad especifica la ciudad del edificio. Si el valor contiene espacios, escriba el valor entre comillas ("). La longitud máxima es de 200 caracteres.

-PaísOrRegión

El parámetro CountryOrRegion especifica el país o la región del edificio. Un valor válido es un código de país de dos letras ISO 3166-1 válido (por ejemplo, AU para Australia) o el nombre descriptivo correspondiente para el país (que puede ser diferente del nombre corto oficial de la Agencia de mantenimiento ISO 3166).

Hay disponible una referencia para los códigos de país de dos letras en la lista de códigos de país.

-Etiqueta

El parámetro Etiqueta especifica una etiqueta descriptiva para el lugar. Si el valor contiene espacios, escriba el valor entre comillas ("). La longitud máxima es de 200 caracteres.

Para salas y áreas de trabajo, el comando actualiza el valor denominado -Label en Exchange Set-Place.

-DisplayDeviceName

El parámetro DisplayDeviceName especifica el nombre del dispositivo de visualización en el lugar (sala, escritorio o área de trabajo). Si el valor contiene espacios, escriba el valor entre comillas (").

El valor predeterminado está en blanco ($null). Para indicar que este lugar no tiene ningún dispositivo de visualización, use el valor $null para este parámetro.

-Etiqueta de piso

El parámetro FloorLabel especifica una etiqueta descriptiva para el suelo. Si el valor contiene espacios, escriba el valor entre comillas (").

-Piso

El parámetro Suelo especifica el criterio de ordenación del suelo dentro de un edificio determinado.

-Geocoordenadas

El parámetro GeoCoordinates especifica la ubicación del edificio en coordenadas de latitud, longitud y (opcionalmente) altitud. Un valor válido para este parámetro utiliza uno de los siguientes formatos:

• Latitud y longitud: Por ejemplo, "47.644125;-122.122411"
• Latitud, longitud y altitud: Por ejemplo, "47.644125;-122.122411; 161.432"

Si los separadores de punto no funcionan, use comas en su lugar.

-IsWheelChairAccessible

El parámetro IsWheelChairAccessible especifica si el lugar es accesible en silla de ruedas. Los valores admitidos son:

• $true: El lugar es accesible para sillas de ruedas.
• $false: El lugar no es accesible para sillas de ruedas. Este es el valor predeterminado.

-MTREnabled

El parámetro MTREnabled identifica la sala como configurada con un sistema de sala de Microsoft Teams. Puede agregar sistemas de sala de Teams como fuentes de audio en las reuniones de Teams en las que participe la sala. Los valores admitidos son:

• $true: La sala tiene un sistema de sala de Teams. Puede agregar el sistema de sala de Teams a las reuniones de Microsoft Teams al seleccionar unirse a una reunión con audio de sala.
• $false: La sala no tiene un sistema de sala de Teams. Los usuarios pueden unirse a las reuniones de Teams con el audio de su PC o dispositivo móvil en lugar de usar el audio de la sala. Este es el valor predeterminado.

Para obtener más información sobre las Salas de Microsoft Teams, consulte Salas de Microsoft Teams.

-DisplayName

El parámetro DisplayName especifica el nombre para mostrar del lugar. La longitud máxima es de 200 caracteres. Para actualizar el nombre para mostrar de una sala o un lugar de trabajo que tiene una dirección SMTP asociada, necesita el rol de administrador de lugar, administrador de Exchange o Administración global.

-ParentId

El parámetro ParentId especifica el identificador de un lugar en la jerarquía de ubicaciones primarias en Microsoft Places. Una habitación debe tener un piso o sección principal. Un área de trabajo o un escritorio deben tener una sección principal. Una sección debe tener un piso principal. Una planta debe tener un edificio principal.

-Código postal

El parámetro PostalCode especifica el código postal del edificio.

-Enlaces de recursos

El parámetro ResourceLinks especifica vínculos externos o id. de aplicación de Teams que deben asociarse a este edificio, como un menú de comedor, un enlace a servicios o una aplicación de Teams para la administración de visitantes. Para obtener más información sobre cómo configurar servicios en Places, consulte Servicios en Places.

El valor debe proporcionarse como una matriz de vínculos, como se muestra en el ejemplo 4. Cada vínculo debe contener las siguientes propiedades: Nombre, Valor y Tipo. Por ejemplo, un vínculo se escribiría como @{name="TestLink"; value="https://contoso.com/"; type="Url"}.

• Nombre

  • Esta cadena se usa para mostrar cómo se muestra el nombre de la aplicación o el vínculo en la aplicación Places.

  • La longitud máxima es de 200 caracteres.

• Valor

  • Este valor debe ser un vínculo de URL o un identificador de aplicación de Teams. Los identificadores de aplicación de Teams se pueden encontrar en la página Detalles de la aplicación en la página Administrar aplicaciones del Centro de administración de Teams.

  • La longitud máxima es de 1.000 caracteres.

• El tipo debe ser uno de los tipos admitidos:

  • Dirección URL: indica que se trata de un vínculo URL.

  • MetaOsApp: indica que este vínculo es una aplicación de Teams.

-SortOrder

El parámetro SortOrder especifica el criterio de ordenación del suelo. Por ejemplo, un piso podría llamarse "Lobby" con un criterio de ordenación de 0 para mostrar este piso primero en las listas ordenadas.

-Estado

El parámetro State especifica el estado o la provincia del edificio. La longitud máxima es de 200 caracteres.

-Calle

El parámetro Street especifica la dirección física del edificio. La longitud máxima es de 200 caracteres.

-Modo

El parámetro Mode define cómo se pretende usar o reservar un lugar. Actualmente, el modo solo está disponible para escritorios y grupos de escritorios (áreas de trabajo).

Actualmente, hay cuatro modos en total.

• Reservable: los escritorios reservables son los escritorios que están configurados para reservarse con anticipación o en el lugar.
• DropIn: el mostrador está disponible para uso en el lugar y no se puede reservar con anticipación. Puede usar la funcionalidad de Microsoft Teams para vincular los dispositivos periféricos presentes en estos escritorios al objeto de escritorio individual del directorio.
• Asignado: un escritorio asignado está vinculado permanentemente a un usuario específico y no puede ser reservado por otros usuarios. Cada escritorio asignado siempre debe tener un usuario designado.
• No disponible: el mostrador no está disponible para reservar debido al mantenimiento o por cualquier otro motivo.

El valor Modo contiene una propiedad Nombre y, para los modos que lo admiten, un diccionario de metadatos. Vea el Ejemplo 7 para ver un ejemplo de modo asignado que incluye metadatos.

• Nombre: el campo Nombre especifica el modo activo de un lugar. Usa un valor de enumeración y las opciones disponibles varían según el tipo de lugar. Para los escritorios, los modos admitidos incluyen Reservable, DropIn, Assigned y Unavailable. Para los grupos de escritorio, los modos admitidos son Reservable, DropIn y Unavailable.

• Metadatos: el campo Metadatos es un diccionario que se usa para almacenar información adicional relevante para el modo seleccionado. Estos metadatos admiten lógica empresarial vinculada a escenarios de reserva específicos.

  • Los Places en los modos Reservable y DropIn no admiten ningún campo de metadatos.
  • Los Places en modo No disponible admiten un Reason campo (cadena) que explica por qué el escritorio no está disponible. Los valores incluyen New para los escritorios recién creados y Maintenance para los Places en proceso de servicio.
  • El modo asignado admite dos campos de metadatos: AssignedPersonEmailAddress y AssignedPersonId. Identifican al usuario asignado al escritorio. Proporcionar cualquiera de los dos campos es suficiente para habilitar el modo asignado.

-Etiquetas

El parámetro Etiquetas especifica características adicionales de la habitación (por ejemplo, detalles como el tipo de vista o el tipo de mobiliario). Actualmente no hay una longitud máxima.

Puede especificar varias etiquetas separadas por comas. Si las etiquetas contienen espacios, escriba los valores entre comillas: "Label 1","Label 2",..."Label N".

Solución de problemas

Recibo un error de permiso denegado.

Set-PlaceV3 requiere uno de los siguientes roles: TenantPlacesManagement, GlobalAdmin o MailRecipients. Dado que los roles se pueden asignar de diferentes maneras, las siguientes son las formas admitidas de asignar permisos de rol:

• Si el permiso se asigna a través del Centro de administración de Exchange (que solo admite permisos permanentes), no debería tener problemas con el uso de los cmdlets de Places. No es de esperar que vea un error de permiso denegado.
• Si el permiso se asigna a través de Entra directamente al usuario (como un rol permanente o temporal), no debería tener problemas con el uso de los cmdlets de Places. No es de esperar que vea un error de permiso denegado. Sin embargo, puede haber algún retraso en la sincronización entre Entra y Exchange.
• Si el permiso se asigna a través de Entra a un grupo en Entra, del que forma parte el usuario, esto no es compatible con Exchange y no se respetará el rol a través del grupo. Se producirá un error en los cmdlets de Exchange y en los cmdlets de Places con permiso denegado. Este comportamiento esperado se describe aquí.

He asignado un ParentId a un recurso, pero todavía no lo veo en el Buscador de Places.

La correlación entre el recurso y su piso principal puede tardar hasta 24 horas en aparecer en las experiencias de Places. Estamos trabajando para eliminar este retraso.

Cómo puedo establecer una foto en un recurso?

La Set-UserPhoto quedó obsoleta en abril de 2024. Estamos trabajando para agregar un parámetro a este cmdlet para establecer una foto en salas y áreas de trabajo cuando se usa Set-PlaceV3. Mientras tanto, siga estas instrucciones y coloque la foto en una habitación o área de trabajo.

Actualmente no es posible colocar fotos en un edificio o en un piso.