Initialize-Places
El Initialize-Places cmdlet es una experiencia simplificada de creación rápida que se puede usar en lugar de los New-Placecmdlets y Set-PlaceV3 .
Initialize-Places analiza las salas y áreas de trabajo existentes en el inquilino e deduce nombres de edificio, suelo y sección. Permite comprobar, editar esta información y, a continuación, crear una jerarquía completa de salas y áreas de trabajo de edificios >> en el inquilino. Esta jerarquía a veces se conoce como Places Directory.
En esta página se proporcionan detalles sobre la sintaxis del cmdlet y las opciones. En Configuración de edificios y pisos se proporciona una guía paso a paso para usar este cmdlet.
Importante
El 14 de noviembre de 2024 se realizaron actualizaciones importantes en el módulo de cmdlets MicrosoftPlaces. Si se unió al programa de versión preliminar antes de esa fecha, obtenga la versión más reciente del módulo ejecutando Run Install-Module -Name MicrosoftPlaces -Forcey, a continuación, cierre y vuelva a iniciar PowerShell.
Sintaxis
En ejecución Initialize-Places se muestra una lista de opciones:
Initialize-Places
Please choose the desired option before continuing:
1. Export suggested mapping CSV of rooms to buildings/floors.
2. Import mapping CSV to automatically create buildings/floors and room mappings.
3. Export PowerShell script with commands to manually create buildings/floors and room mappings based on an imported CSV.
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.
Opción 1
Esta opción analiza las salas y las áreas de trabajo configuradas en el inquilino y genera un archivo CSV denominado ResourceAccountsMapped.csv. Este archivo CSV contiene otros datos, como los nombres de edificio, planta y sección, que se deducen de los datos room, workplace y RoomList.
El archivo CSV solo incluye salas y áreas de trabajo que se encuentran en Exchange Online que están asociadas a RoomList y que aún no están vinculadas a un piso o sección en Places Directory.
Por ejemplo:
Places no están asociadas a ningún objeto RoomList no se incluyen en el ARCHIVO CSV. Estas salas no son visibles en el buscador de salas y se excluyen de forma predeterminada para asegurarse de que no aparecen en Places Finder a menos que las agregue manualmente.
se incluyen Places asociados con dos o más RoomList. Sin embargo, el nombre de compilación inferido se deja en blanco. Debe escribir en el nombre de compilación correcto.
Places ya tiene un elemento primario en una planta o una sección no se incluyen en el CSV. Puede ejecutar el script de forma iterativa cuando se agreguen nuevas salas y áreas de trabajo en Exchange Online y el archivo CSV de salida solo debe incluir las nuevas salas y áreas de trabajo.
Para obtener instrucciones sobre cómo exportar otras salas y áreas de trabajo, consulte Configuración de edificios y pisos, configuración manual.
Opción 2
Una vez validada la sala y la información del área de trabajo generada por la opción 1, debe quitar las columnas innecesarias tal como se descriptan en Configurar edificios y pisos y guardarlo como un nuevo archivo CSV. Ahora está listo para volver a escribir esta información en el directorio de Places mediante la opción 2.
Cualquier nuevo edificio, piso o sección que se encuentre en el archivo CSV se agrega al directorio de Places y las nuevas salas y lugares de trabajo se asignan a plantas o secciones.
Puede desglosar el trabajo mediante la construcción, la ciudad o cualquier otro criterio. Este enfoque le permite cargar iterativamente archivos CSV más pequeños que contienen un subconjunto de salas y lugares de trabajo que desea agregar a su directorio de Places. Cada vez que cargue un nuevo archivo CSV, los edificios, los pisos y las secciones que aún no están en el directorio de Places se agregan a la jerarquía.
Después de cargar el archivo CSV, se genera un archivo denominado fileToImport-ImportResults.csv y se guarda en la misma carpeta. Este archivo documenta si se encontraron problemas durante la carga. En esta fase, una jerarquía completa de datos espaciales está disponible para que la usen Microsoft Places en el inquilino.
La carga de un archivo CSV hace que los nombres de edificios se vuelvan visibles en la experiencia de Microsoft 365. En la práctica, esto significa que los usuarios pueden ver y elegir estos edificios en
Planes de trabajo (es decir, horas de trabajo y ubicación de Outlook)
Presencia en el área de trabajo
otras experiencias como se describe en Microsoft Places información general.
Importante
Asegúrese de que cada edificio, planta y sección se escriben exactamente de la misma manera en el archivo CSV y en los archivos CSV si los carga de forma iterativa. Las diferencias dan lugar a la creación de edificios, pisos o secciones adicionales.
Opción 3
Esta opción avanzada permite revisar el script de PowerShell que configura el directorio de Places antes de ejecutarlo. Con esta opción, el script de PowerShell se descarga en el equipo, pero no se ejecuta. La opción 3 puede ser útil si necesita separar tareas administrativas entre varias personas.
El script de PowerShell se denomina PlacesOnboardingScript.ps1 y se guarda en la misma carpeta que el archivo CSV cargado. Debe ejecutar manualmente el script de PowerShell para configurar el directorio de Places.
Nota:
La descripción del cmdlet usa incorrectamente el término "import" para la opción 3, pero esta opción no crea nada en el directorio de Places. Solo genera el script que debe ejecutar manualmente.
Formatos de archivo
Formato de archivo del archivo exportado (opción 1)
| Nombre de columna | Descripción |
|---|---|
| InferredBuildingName | Microsoft Places intenta deducir (sugerir) lo que cree que es el nombre de edificio de esta sala o área de trabajo, en función de la propiedad de edificio de la sala o las áreas de trabajo, y la lista de salas asociada. Esta columna se debe revisar & actualizar con el valor correcto antes de importar (opción 2 o 3). |
| InferredFloorName | Microsoft Places intenta deducir (sugerir) lo que cree que es el nombre del piso de esta sala o área de trabajo, en función de la propiedad floorLabel de la sala o las áreas de trabajo y la lista de salas asociada. Esta columna se debe revisar & actualizar con el valor correcto antes de importar (opción 2 o 3). |
| InferredSectionName | Microsoft Places sugiere el nombre del piso (InferredFloorName) como nombre de sección de las áreas de trabajo y lo deja en blanco para las salas. Esta columna se debe revisar & actualizar con el valor correcto antes de importar (opción 2 o 3) |
| CurrentBuildingLabel | Valor de cadena actual del conjunto de compilación en los metadatos de la sala o del área de trabajo |
| CurrentFloorNumber | Valor entero actual del conjunto de plantas en los metadatos de la sala o del área de trabajo |
| CurrentFloorLabel | Valor de cadena actual de floorLabel establecido en los metadatos de la sala o del área de trabajo |
| PrimarySmtpAddress | Dirección smtp de la sala o área de trabajo |
| Nombre | Nombre para mostrar de la sala o área de trabajo |
| RoomList | Lista de salas asociada de las salas o áreas de trabajo |
| ResourceType | Define si el recurso es una sala o un espacio (área de trabajo) |
| StreetAddress | La dirección de la calle de la sala o área de trabajo |
| Ciudad | La ciudad de la sala o área de trabajo |
| StateOrProvince | Estado o provincia de la sala o área de trabajo |
| CountryOrRegion | País o región de la sala o área de trabajo |
| Intervalo.Confianza | El nivel de confianza en el nombre del edificio inferido y el nombre del piso inferido |
Formato de archivo necesario para la importación (opción 2 y 3)
El archivo importado solo debe tener las cuatro columnas siguientes:
| Nombre de columna | Descripción |
|---|---|
| InferredBuildingName | (obligatorio) Este nombre se usa al crear el edificio. |
| InferredFloorName | (obligatorio) Este nombre se usa al crear el suelo. |
| InferredSectionName | Este nombre se usa al crear la sección (una zona o barrio en el suelo). Este nombre es necesario para las áreas de trabajo, pero es opcional para las salas. |
| PrimarySmtpAddress | (obligatorio) Dirección smtp de la sala o área de trabajo |