Set-PlaceV3

Use el cmdlet Set-PlaceV3 para actualizar los metadatos sobre los escritorios, las salas, las áreas de trabajo, las secciones, los pisos o los edificios 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, una vecindad. Los escritorios y áreas de trabajo deben estar primarios a una sección. Las habitaciones también pueden ser primarias a una sección o pueden ser directamente primarias a un piso.

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

Escritorio

Los escritorios son un tipo de entidad recién 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 de modo siguiente.

Para Desk, hay algunas dependencias entre el modo y el buzón de correo como se indica a continuación:

• Si no se define la propiedad Mode, el escritorio tiene como valor predeterminado 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. Una se crea automáticamente cuando se aprovisiona el escritorio. Como alternativa, puede vincular un buzón existente especificando EmailAddress en el parámetro Mailbox.
• En el caso de los escritorios en modo Asignado o No disponible, vincular un buzón es opcional y no se crea ningún buzón de forma predeterminada. Sin embargo, puede asociar manualmente estos escritorios a buzones personalizados si es necesario.
• Si no hay ningún modo configurado 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 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 reserva usa principalmente el buzón de correo, mientras que los metadatos se leen desde el directorio 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 -ParentId parámetro , los detalles de ubicación (Street y City) deben administrarse en el nivel de edificio, no en la sala o área de trabajo individuales.

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 con el -ParentId parámetro , los detalles de ubicación (Street y City) deben administrarse en el nivel de edificio, no en la sala o área de trabajo individuales.

El área de trabajo admite la propiedad Mode. Los detalles del mismo 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 completamente configurada entre las salas o áreas de trabajo, los pisos y los edificios. Una vez creados los edificios y los pisos, puede vincularlos mediante parentId. Una habitación debe tener una planta o sección primaria. Un área de trabajo o un escritorio deben tener una sección primaria. Una sección debe tener una planta primaria. Un piso debe tener un edificio primario.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Debe tener el rol 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-ff24923338d.

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 al actualizarse. Para agregar o quitar un valor, asegúrese de incluir valores anteriores que deben conservarse.

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 escritorio aparece en Places Finder y está disponible para la reserva por cualquier persona.

$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 del modo al modo DropIn.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -Mode @{Name='DropIn'}

Ejemplo 7

En este ejemplo se actualiza el valor de modo al 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 antiguo.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a Mode @{Name='Assigned';Metadata=$modemetadata}

Parameters

-Identidad

El parámetro identity especifica el lugar que desea actualizar. Puede usar cualquier valor que identifique de forma única un lugar.

Por ejemplo, para lugares basados en un buzón de correo (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, pisos, 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 para el parámetro .

-Edificio

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

-Capacidad

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

-Ciudad

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

-CountryOrRegion

El parámetro CountryOrRegion especifica el país o 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 podría 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 Lista de códigos de país.

-Etiqueta

El parámetro Label 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 para mostrar 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.

-FloorLabel

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 Floor especifica el criterio de ordenación del piso dentro de un edificio determinado.

-GeoCoordinates

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

• 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 automáticamente, use comas en su lugar.

-IsWheelChairAccessible

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

• $true: El lugar es accesible en silla 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 salas de Microsoft Teams. Puede agregar sistemas de salas de Teams como orígenes de audio en reuniones de Teams que impliquen la sala. Los valores admitidos son:

• $true: La sala tiene un sistema de salas de Teams. Puede agregar el sistema de salas 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 salas de Teams. Los usuarios pueden unirse a las reuniones de Teams con su equipo o audio de dispositivo móvil en lugar de usar audio de sala. Este es el valor predeterminado.

Para obtener más información sobre 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 área de trabajo que tenga una dirección SMTP asociada, necesita el rol Administrador de ubicación, Administrador de Exchange o Administración global.

-ParentId

El parámetro ParentId especifica el identificador de un elemento Place en la jerarquía de ubicación primaria de Microsoft Places. Una habitación debe tener una planta o sección primaria. Un área de trabajo o un escritorio deben tener una sección primaria. Una sección debe tener una planta primaria. Un piso debe tener un edificio primario.

-PostalCode

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

-ResourceLinks

El parámetro ResourceLinks especifica vínculos externos o identificadores de aplicación de Teams que deben asociarse a este edificio, como un menú de comedor, un vínculo 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 vínculo o el nombre de la aplicación en la aplicación Places.

  • La longitud máxima es de 200 caracteres.

• Valor

  • Este valor debe ser un vínculo 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 de la página Administrar aplicaciones del Centro de administración de Teams.

  • La longitud máxima es de 1000 caracteres.

• El tipo debe ser uno de los tipos admitidos:

  • 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 denominarse "Lobby" con un criterio de ordenación de 0 para mostrar este primer piso en 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 escritorio (áreas de trabajo).

Actualmente, hay cuatro modos en total.

• Reservable- Los escritorios reservables son los que están configurados para reservarse con antelación o en el lugar.
• El escritorio está disponible para su uso local y no se puede reservar con antelació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á permanentemente vinculado 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 escritorio no está disponible para la reserva debido a mantenimiento o por cualquier otro motivo.

El valor de modo debe contener las siguientes propiedades: Nombre y Metadatos, como se muestra en el ejemplo 6. El nombre es una cadena y los metadatos son un objeto de diccionario.

• 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, DropInAssigned y Unavailable. En el caso de 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 la lógica de negocios asociada a escenarios de reserva específicos.

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

-Etiquetas

El parámetro Tags especifica características adicionales de la sala (por ejemplo, detalles como el tipo de vista o el tipo de mobiliario). Actualmente no hay ninguna longitud máxima.

Puede especificar varias etiquetas separadas por comas. Si las etiquetas contienen espacios, incluya 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 MailRecepients. 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 debe tener problemas con el uso de los cmdlets de Places. No se esperaría 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 debe tener problemas con el uso de los cmdlets de Places. No se esperaría 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 de Entra, del que forma parte el usuario, Exchange no admite este permiso y no se respetará el rol por grupo. Los cmdlets de Exchange y los cmdlets de Places producirán un error con el permiso denegado. Este comportamiento esperado se describe aquí.

Asigné un ParentId a un recurso, pero aún no lo veo en Places Finder.

La correlación entre el recurso y su elemento primario Floor puede tardar hasta 24 horas en aparecer en Places experiencias. Estamos trabajando para eliminar este retraso.

Cómo establecer una foto en un recurso?

El Set-UserPhoto quedó en desuso en abril de 2024. Estamos trabajando en 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 para establecer la foto en una sala o área de trabajo.

Actualmente no es posible establecer fotos en un edificio o en una planta.