Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |