Set-PlaceV3
Use el cmdlet Set-PlaceV3 para actualizar los metadatos sobre las salas, las áreas de trabajo, los pisos o los edificios del directorio de Places.
Nota:
- Novedades a salas de conferencias & las áreas de trabajo pueden tardar hasta 24 horas en reflejarse. Si necesita incorporar varias salas y áreas de trabajo, se recomienda usar
Initialize-Places, que es capaz de forzar que los cambios se reflejen inmediatamente. - 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.
Sintaxis
Creación
Set-PlaceV3
[-Identity]
[-DisplayName]
[-Label]
[-IsWheelChairAccessible]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-ResourceLinks]
[-Tags]
Floor
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-SortOrder]
[-Tags]
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]
[-Tags]
Escritorio
Los escritorios son un nuevo tipo de entidad en Places, que representan escritorios individuales. Estos objetos pueden ser reservables o no reservables (valor predeterminado).
Para que un escritorio se pueda reservar, es necesario crear un buzón de escritorio y asociarlo con el objeto desk pasando el buzón Alias al Mailbox parámetro de Set-PlaceV3. Tenga en cuenta que, a diferencia de los tipos de sala o área de trabajo, los escritorios no se aprovisionan implícitamente mediante la creación del buzón solo. Además, los metadatos (como los Capacity campos o DisplayName ) no se mantienen sincronizados con los metadatos del buzón. El buzón solo es necesario para el motor de reserva y los metadatos se leerán en Places Directory.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
Sala o área de trabajo
Set-PlaceV3 admite parámetros de ubicación heredados ya expuestos 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 , la -ParentId información de ubicación (Street, City, , etc.) debe administrarse en el edificio en lugar de en la sala o área de trabajo.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Capacity]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-Building]
[-Floor]
[-FloorLabel]
[-Tags]
Descripción
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.
Precaución
Es posible que encuentre parámetros adicionales en el cmdlet de PowerShell, pero no se admiten actualmente. No se recomienda usar ningún parámetro que no esté documentado en esta página.
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 geocoordinaciones 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 buzón de escritorio y se asigna a una entidad de escritorio existente. Tenga en cuenta que debe tener instalado ExchangeOnlineManagement el módulo y ejecutar el Connect-ExchangeOnline cmdlet antes de ejecutar lo siguiente:
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
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
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Por ejemplo, para lugares que no se basan en un buzón (edificios, pisos, secciones y escritorios):
- Nombre
- GUID
| Atributo | Description |
|---|---|
| Tipo: | RecipientIdParameter |
| Posición: | 0 |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Verdadero |
| Acepte caracteres comodín: | Falso |
-AudioDeviceName, -DisplayDeviceName y VideoDeviceName
Estos parámetros especifican el nombre de los dispositivos de audio, visualización y vídeo en 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, visualización o vídeo, use el valor $null para el parámetro .
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-Edificio
Importante
El parámetro de compilación está en desuso y se proporciona aquí solo para la compatibilidad con versiones anteriores. La información de compilación se leerá desde la entidad Building que se encuentra en la cadena primaria de la sala o área de trabajo.
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 (").
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-Capacidad
El parámetro Capacity especifica la capacidad de la sala. Un valor válido es un entero.
| Atributo | Description |
|---|---|
| Tipo: | System.Int32 |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
Se recomienda administrar los datos de ubicación en el edificio en lugar de en la sala o área de trabajo. Hay una jerarquía entre habitaciones -> pisos -> edificios y salas heredan los atributos de ubicación de su edificio.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
Se recomienda administrar los datos de ubicación en el edificio en lugar de en la sala o área de trabajo. Hay una jerarquía entre habitaciones -> pisos -> edificios y salas heredan los atributos de ubicación de su edificio.
| Atributo | Description |
|---|---|
| Tipo: | CountryInfo |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Verdadero |
| Acepte caracteres comodín: | Falso |
-DisplayDeviceName
El parámetro DisplayDeviceName especifica el nombre del dispositivo para mostrar en 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 visualización, use el valor $null para este parámetro.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-FloorLabel
El parámetro FloorLabel especifica una etiqueta descriptiva para el suelo. Si el valor contiene espacios, escriba el valor entre comillas (").
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-Piso
El parámetro Floor especifica el criterio de ordenación del piso dentro de un edificio determinado.
| Atributo | Description |
|---|---|
| Tipo: | System.Int32 |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
Se recomienda administrar los datos de ubicación en el edificio en lugar de en la sala o área de trabajo. Hay una jerarquía entre las salas ,> los pisos,> los edificios y las habitaciones heredan los atributos de ubicación de su edificio.
| Atributo | Description |
|---|---|
| Tipo: | GeoCoordinates |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
| Atributo | Description |
|---|---|
| Tipo: | Booleano |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-MTREnabled
Nota:
Actualmente, este parámetro es solo informativo y no da lugar a ninguna funcionalidad adicional.
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.
| Atributo | Description |
|---|---|
| Tipo: | Booleano |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-DisplayName
El parámetro DisplayName especifica el nombre para mostrar del lugar. La longitud máxima es de 200 caracteres. Set-PlaceV3 solo puede actualizar el nombre de los lugares que no tienen una dirección SMTP asociada, como edificios y pisos. Para actualizar el nombre para mostrar de un lugar que tiene una dirección SMTP asociada, como salas de conferencias y áreas de trabajo, use el cmdlet exchange Set-Mailbox.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Valor predeterminado: | Ninguno |
| Necesario: | Verdadero |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
Nota:
Si necesita compatibilidad con versiones anteriores con Outlook Roomfinder, asegúrese de actualizar también las propiedades "Floor"/"FloorLabel", en paralelo con la creación de elementos primarios de la sala a la entidad floor. Places Finder usará la nueva jerarquía, mientras que Roomfinder de Outlook cooperará para usar los objetos heredados "Floor" y "FloorLabel". También tendrá que asegurarse de que la sala está asociada a una lista de salas, como se documenta aquí Configuración de salas y áreas de trabajo para room finder en Outlook.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-PostalCode
El parámetro PostalCode especifica el código postal del edificio.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
Nota:
Todo el conjunto se reemplazará al actualizar. Para agregar o quitar un valor, asegúrese de incluir valores anteriores que deben conservarse.
| Atributo | Description |
|---|---|
| Tipo: | Vínculo[] |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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.
| Atributo | Description |
|---|---|
| Tipo: | System.Int32 |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-Estado
El parámetro State especifica el estado o la provincia del edificio. La longitud máxima es de 200 caracteres.
Se recomienda administrar los datos de ubicación en el edificio en lugar de en la sala o área de trabajo. Hay una jerarquía entre las habitaciones ,> los pisos,> los edificios y la sala hereda los atributos de ubicación de su edificio.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-Calle
El parámetro Street especifica la dirección física del edificio. La longitud máxima es de 200 caracteres.
Se recomienda administrar los datos de ubicación en el edificio en lugar de en la sala o área de trabajo. Hay una jerarquía entre habitaciones -> pisos -> edificios y salas heredan los atributos de ubicación de su edificio.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
-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".
Nota:
Todo el conjunto se reemplazará al actualizar. Para agregar o quitar un valor, asegúrese de incluir valores anteriores que deben conservarse.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Falso |
| Acepte caracteres comodín: | Falso |
Solución de problemas
Recibo un error de permisos denegados.
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 espera 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 espera 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.