New-Place
Use el cmdlet New-Place para crear edificios, pisos, secciones o escritorios en el directorio de Places.
Nota:
Para crear salas o áreas de trabajo, debe seguir usando el cmdlet New-Mailbox documentado aquí.
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 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.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
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 sala/á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 leen desde Places Directory.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-GeoCoordinates]
[-Mailbox]
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 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 sección primaria a un piso y, a continuación, se crea un buzón de escritorio y se asigna a una entidad de escritorio existente. Tenga en cuenta que tiene ExchangeOnlineManagement instalado el módulo y ejecute el Connect-ExchangeOnline cmdlet antes de ejecutar este script de ejemplo.
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias
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.
| 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.
La información de dirección se usa en la página Explorar Places para mostrar los edificios cercanos.
| 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.
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Falso |
| Aceptar entrada de canalización: | Verdadero |
| 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"
Nota:
Si los separadores de punto no funcionan automáticamente, use comas en su lugar.
| Atributo | Description |
|---|---|
| Tipo: | GeoCoordinates |
| 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.
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.
| 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 usa la nueva jerarquía, mientras que Outlook Roomfinder sigue usando los objetos heredados "Floor" y "FloorLabel". También debe asegurarse de que la sala está asociada a roomlist, 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. La longitud máxima es de 200 caracteres.
| 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:
Se reemplaza todo el conjunto. Para agregar o quitar un valor, asegúrese de incluir valores anteriores que deben conservarse.
| Atributo | Description |
|---|---|
| Tipo: | ResourceLink[] |
| 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.
| 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.
| 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 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".
Nota:
Todo el conjunto se reemplaza al actualizarse. 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 |
-Tipo
El parámetro Type especifica el tipo del lugar que se está creando. Los valores admitidos son:
- Creación
- Floor
- Sección
- Escritorio
| Atributo | Description |
|---|---|
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor predeterminado: | Ninguno |
| Necesario: | Verdadero |
| Aceptar entrada de canalización: | Verdadero |
| Acepte caracteres comodín: | Falso |