New-Place

Use el cmdlet New-Place para crear edificios, pisos, secciones, salas, áreas de trabajo o escritorios dentro del directorio de Places.

Sintaxis

Creación

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

Floor

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-SortOrder]
 [-Tags]

Sección

Una sección es una agrupación lógica de espacios dentro de un piso, como un barrio.

• Los escritorios y áreas de trabajo deben pertenecer a una sección.
• Las habitaciones se pueden asignar a una sección o directamente asociadas a una planta.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

Sala

La creación de una sala aprovisiona automáticamente un buzón asociado. Si proporciona un EmailAddress en el parámetro Mailbox, se creará un nuevo buzón con ese nombre y se vinculará a la sala.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Área de trabajo

La creación de un área de trabajo (grupo de escritorio) aprovisiona automáticamente un buzón asociado. Si proporciona un EmailAddress en el parámetro Mailbox, se creará un nuevo buzón con ese nombre y se vinculará al área de trabajo.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Escritorio

Un escritorio representa una unidad de escritorio individual. Cada escritorio tiene una propiedad Mode que define cómo se puede usar:

• Reservable : se puede reservar con antelación.
• Drop-In : disponible solo para uso local.
• Asignado : asignado a un usuario específico.
• No disponible : no disponible para la reserva.

El modo de escritorio y el buzón funcionan de la siguiente manera:

• Comportamiento predeterminado: Si el modo no está definido, el escritorio tiene como valor predeterminado No disponible. No se crea ningún buzón.
• Modo Reservable o DropIn: Se requiere un buzón de escritorio. Uno se crea automáticamente cuando se aprovisiona el escritorio o se puede vincular a uno existente.
  • Si proporciona un EmailAddress existente en el parámetro Mailbox, el escritorio se vincula a ese buzón.
  • Si proporciona un EmailAddress que no existe, se crea un nuevo buzón con ese nombre y se vincula al escritorio.
  • Si no se proporciona EmailAddress, se crea automáticamente un buzón con un nombre generado por el sistema y vinculado al escritorio.
• Modo asignado o no disponible: Vincular un buzón es opcional y no se crea ningún buzón. Sin embargo, puede asociar manualmente estos escritorios a buzones personalizados si es necesario.
• Cambiar el modo más adelante: Si el escritorio se inicia en modo No disponible y no hay ningún buzón vinculado, al cambiar el escritorio a Reservable mediante el cmdlet Set-PlacesV3 se creará y vinculará automáticamente un buzón. Sin embargo, vincular un buzón a un escritorio no actualiza automáticamente el modo del escritorio.

A diferencia de las salas o áreas de trabajo, los escritorios no sincronizan metadatos como Capacity o DisplayName 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.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]
 [-Mode]

Description

Microsoft Places requiere una jerarquía completa para edificios, pisos, secciones, salas, áreas de trabajo y escritorios.

• Un piso debe pertenecer a un edificio.
• Una sección debe pertenecer a un piso.
• Una habitación debe pertenecer a una planta o sección.
• Un área de trabajo o un escritorio deben pertenecer a una sección.

Use la propiedad ParentId para vincular entidades.

Para ejecutar este cmdlet, necesita uno de estos roles: administrador de Places, administrador de Exchange o roles personalizados con permisos TenantPlacesManagement.

Ejemplos

Ejemplo 1

En este ejemplo se crea un nuevo edificio y un piso dentro de ese edificio.

New-Place -Type Building -Name 'Building 3'

Una vez que el edificio 3 se haya creado correctamente, lea su PlaceId para usarlo al establecer parentId en los pisos.

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

Ejemplo 2

En este ejemplo se crea un nuevo edificio con información de dirección.

New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

Ejemplo 3

En este ejemplo se crea un nuevo edificio con vínculos de recursos.

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

Ejemplo 4

En este ejemplo se crea una nueva sala primaria a una sección y con una capacidad 10, sin especificar los detalles del buzón. Se crea y vincula automáticamente un buzón de sala.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Capacity 10

Ejemplo 5

En este ejemplo se crea una nueva sala primaria a una sección y se proporcionan los detalles de un buzón.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Ejemplo 6

En este ejemplo se crea un nuevo área de trabajo (grupo de escritorio) primaria a una sección y se proporcionan los detalles de un buzón.

New-Place -Name 'Deskpool A' -Type Workspace -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Ejemplo 7

En este ejemplo se crea un escritorio reservable con una sección primaria 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 8

En este ejemplo se crea un escritorio reservable primario a una sección y se proporciona un buzón de correo. Si el buzón existe, el escritorio se vinculará a él; de lo contrario, se creará automáticamente un nuevo buzón de escritorio con el nombre proporcionado.

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

Ejemplo 9

En este ejemplo se crea un escritorio de modo asignado primario a una sección y se asigna a una persona. Solo la persona asignada puede usar este escritorio. Otros ya no pueden reservarla.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
New-Place -Name 'Bookable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Assigned';Metadata=$modemetadata}

Parameters

-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.

La información de dirección se usa en la página Explorar Places para mostrar los edificios cercanos.

-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.

-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"

-DisplayName

El parámetro DisplayName especifica el nombre para mostrar del lugar. La longitud máxima es de 200 caracteres.

El nombre para mostrar de un edificio está visible:

• En Outlook, cuando los usuarios configuran sus horas de trabajo y ubicación, pueden seleccionar un edificio.
• En Places página Explorar que muestra quién más está en el mismo edificio, edificios cercanos y mucho más.
• En Places Finder, como filtro al buscar una sala de conferencias o un área de trabajo.

El nombre para mostrar de un piso es visible en Places Finder como filtro al buscar una sala de conferencias o un área de trabajo.

-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. La longitud máxima es de 200 caracteres.

-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.

-Etiquetas

El parámetro Tags especifica otras características de la habitación (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".

-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.
• Drop-in- El escritorio está disponible para su uso en el lugar 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 5. 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, Drop-InAssigned y Unavailable. En el caso de los grupos de escritorio, los modos admitidos son Reservable, Drop-In 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 Drop-In 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.

-Tipo

El parámetro Type especifica el tipo del lugar que se está creando. Los valores admitidos son:

• Creación
• Floor
• Sección
• Sala
• Área de trabajo
• Escritorio