Initialize-Places

O Initialize-Places cmdlet é uma experiência simplificada e de criação rápida que pode ser usada em vez dos New-Placecmdlets , e Set-PlaceV3 .

Initialize-Places analisa salas e espaços de trabalho existentes em seu locatário e infere nomes de edifícios, andares e seções. Ele permite verificar, editar essas informações e, em seguida, criar uma hierarquia completa de edifícios > , pisos > , salas e espaços de trabalho em seu locatário. Às vezes, essa hierarquia é chamada de Diretório de Places.

Esta página fornece detalhes sobre a sintaxe e as opções do cmdlet. Um guia passo a passo para usar esse cmdlet é fornecido em Configurar edifícios e andares.

Importante

Atualizações importantes foram feitas no módulo de cmdlet MicrosoftPlaces em 14 de novembro de 2024. Se você ingressou no programa de visualização antes dessa data, obtenha a versão mais recente do módulo executando Run Install-Module -Name MicrosoftPlaces -Forcee, em seguida, feche e reinicie o PowerShell.

Sintaxe

A execução Initialize-Places mostra uma lista de opções:

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.

Cuidado

Você pode encontrar parâmetros adicionais no cmdlet do PowerShell, mas esses não são suportados no momento. Não é recomendável usar nenhum parâmetro que não esteja documentado nesta página.

Opção 1

Essa opção analisa salas e espaços de trabalho configurados em seu locatário e gera um arquivo CSV chamado ResourceAccountsMapped.csv. Este arquivo CSV contém outros dados, como nomes de edifícios, andares e seções, que são inferidos dos dados de salas, local de trabalho e Lista de salas.

O arquivo CSV inclui apenas salas e espaços de trabalho encontrados no Exchange Online que estão associados a uma Lista de Salas e ainda não são pais de um andar ou seção no Diretório de Places.

Por exemplo:

  • Places não associados a nenhuma RoomList não estão incluídos no CSV. Essas salas não são visíveis no Localizador de salas e são excluídas por padrão para garantir que não apareçam no Localizador de Places, a menos que você as adicione manualmente.

  • Places associados a dois ou mais RoomList estão incluídos. No entanto, o nome do edifício inferido é deixado em branco. Você precisa escrever o nome correto do edifício.

  • Places já associados a um andar ou uma seção não estão incluídos no CSV. Você pode executar o script iterativamente quando novas salas e espaços de trabalho forem adicionados no Exchange Online, e o arquivo CSV de saída deverá incluir apenas as novas salas e espaços de trabalho.

Para obter orientação sobre como exportar outras salas e espaços de trabalho, consulte Configurar edifícios e andares, configuração manual.

Opção 2

Depois que as informações de sala e espaço de trabalho geradas pela Opção 1 forem validadas, você deve remover colunas desnecessárias conforme descrito em Configurar edifícios e andares e salvá-lo como um novo arquivo CSV. Agora você está pronto para gravar essas informações de volta em seu Places Directory usando a Opção 2.

Qualquer novo edifício, andar ou seção encontrado no arquivo CSV é adicionado ao seu diretório de Places, e novas salas e locais de trabalho são associados a andares/seções.

Você pode dividir o trabalho por edifício, cidade ou qualquer outro critério. Essa abordagem permite carregar iterativamente arquivos CSV menores que contêm um subconjunto de salas e locais de trabalho que você deseja adicionar ao seu diretório do Places. Toda vez que você carrega um novo arquivo CSV, edifícios, andares e seções que ainda não estão em seu diretório de Places são adicionados à hierarquia.

Depois de carregar o arquivo CSV, um arquivo chamado fileToImport-ImportResults.csv é gerado e salvo na mesma pasta. Este arquivo documenta se algum problema foi encontrado durante o upload. Nesse estágio, uma hierarquia completa de dados espaciais fica disponível para ser usada pelo Microsoft Places em seu locatário.

O upload de um arquivo CSV faz com que os nomes de edifícios se tornem visíveis na experiência do Microsoft 365. Na prática, isso significa que os usuários podem ver e escolher esses edifícios em

  • Planos de trabalho (ou seja, o horário de trabalho e o local do Outlook)

  • Presença no local de trabalho

  • outras experiências, conforme descrito na visão geral do Microsoft Places.

Importante

Certifique-se de que cada edifício, andar e seções estejam escritos exatamente da mesma maneira no arquivo CSV e em arquivos CSV se você carregá-los iterativamente. As diferenças resultam na criação de edifícios, andares ou seções adicionais.

Opção 3

Essa opção avançada permite que você revise o script do PowerShell que configura o diretório do Places antes de executá-lo. Com essa opção, o script do PowerShell é baixado para o computador, mas não é executado. A opção 3 pode ser útil se você precisar separar tarefas administrativas entre várias pessoas.

O script do PowerShell é chamado PlacesOnboardingScript.ps1 e é salvo na mesma pasta que o arquivo CSV carregado. Você precisa executar manualmente o script do PowerShell para configurar o diretório do Places.

Observação

A descrição do cmdlet usa incorretamente o termo "importar" para a Opção 3, mas essa opção não cria nada no seu Diretório de Places. Ele apenas gera o script que você precisa executar manualmente.

Formatos de arquivo

Formato de arquivo do arquivo exportado (Opção 1)

Nome da coluna Descrição
InferredBuildingName O Microsoft Places tenta inferir (sugerir) o que acredita ser o nome do edifício para esta sala/espaço de trabalho, com base na propriedade de edifício da sala/espaços de trabalho e na lista de salas associada. Essa coluna deve ser revisada & atualizada com o valor correto antes da importação (Opção 2 ou 3).
InferredFloorName O Microsoft Places tenta inferir (sugerir) o que acredita ser o nome do andar dessa sala/espaço de trabalho, com base na propriedade floorLabel da sala/espaços de trabalho e na lista de salas associada. Essa coluna deve ser revisada & atualizada com o valor correto antes da importação (Opção 2 ou 3).
InferredSectionName O Microsoft Places sugere o nome do andar (InferredFloorName) como o nome da seção para espaços de trabalho e o deixa em branco para salas. Essa coluna deve ser revisada & atualizada com o valor correto antes da importação (Opção 2 ou 3)
CurrentBuildingLabel O valor da cadeia de caracteres atual do conjunto de construção nos metadados da sala ou espaço de trabalho
CurrentFloorNumber O valor inteiro atual do andar definido nos metadados da sala ou espaço de trabalho
CurrentFloorLabel O valor da cadeia de caracteres atual de floorLabel definido nos metadados da sala ou espaço de trabalho
PrimarySmtpAddress O endereço smtp da sala ou espaço de trabalho
Nome O nome de exibição da sala/espaço de trabalho
RoomList A lista de salas associada das salas/espaços de trabalho
ResourceType Define se o recurso é uma Sala ou um Espaço (espaço de trabalho)
StreetAddress O endereço da sala/espaço de trabalho
Cidade A cidade da sala/espaço de trabalho
StateOrProvince O estado/província da sala/espaço de trabalho
CountryOrRegion O país/região da sala/espaço de trabalho
Confidence O nível de confiança no nome do edifício inferido e o nome do andar inferido

Formato de arquivo necessário para importação (opções 2 e 3)

O arquivo importado deve ter apenas as quatro colunas a seguir:

Nome da coluna Descrição
InferredBuildingName (obrigatório) Este nome é usado ao criar o edifício
InferredFloorName (obrigatório) Este nome é usado ao criar o piso.
InferredSectionName Este nome é usado ao criar a seção (uma zona ou bairro no andar). Esse nome é necessário para espaços de trabalho, mas é opcional para salas.
PrimarySmtpAddress (obrigatório) O endereço smtp da sala ou espaço de trabalho