Initialize-Places
O Initialize-Places cmdlet é uma experiência simplificada e de criação rápida que pode ser utilizada em vez dos New-Placecmdlets e Set-PlaceV3 .
Initialize-Places analisa as salas existentes e as áreas de trabalho no seu inquilino e infere nomes de edifícios, pisos e secções. Permite-lhe verificar, editar estas informações e, em seguida, criar uma hierarquia completa de Salas de Pisos de Edifícios >> e Áreas de Trabalho no seu inquilino. Por vezes, esta hierarquia é denominada diretório Places.
Esta página fornece detalhes sobre a sintaxe do cmdlet e as opções. É fornecido um guia passo a passo para utilizar este cmdlet em Configurar edifícios e pisos.
Importante
Foram feitas atualizações importantes ao módulo de cmdlets microsoftPlaces a 14 de novembro de 2024. Se tiver aderido ao programa de Pré-visualização antes dessa data, obtenha a versão mais recente do módulo ao executar 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
Poderá encontrar parâmetros adicionais no cmdlet do PowerShell, mas estes não são atualmente suportados. Não é recomendado utilizar qualquer parâmetro que não esteja documentado nesta página.
Opção 1
Esta opção analisa salas e áreas de trabalho configuradas no seu inquilino e gera um ficheiro CSV com o nome ResourceAccountsMapped.csv. Este ficheiro CSV contém outros dados, como nomes de edifícios, pisos e secções, que são inferidos a partir das salas, área de trabalho e dados da RoomList.
O ficheiro CSV inclui apenas salas e áreas de trabalho encontradas em Exchange Online que estão associadas a uma RoomList e que ainda não estão ligadas a um piso ou secção no diretório do Places.
Por exemplo:
Places não estão associadas a nenhuma Lista de Salas não estão incluídas no CSV. Estas salas não estão visíveis no Localizador de salas e são excluídas por predefinição para garantir que não aparecem no Places Finder, a menos que as adicione manualmente.
Places associados a duas ou mais RoomList estão incluídos. No entanto, o nome do edifício inferido é deixado em branco. Tem de escrever no nome de edifício correto.
Places já está a par de um piso ou uma secção não está incluída no CSV. Pode executar o script iterativamente quando forem adicionadas novas salas e áreas de trabalho no Exchange Online e o ficheiro CSV de saída deve incluir apenas as novas salas e áreas de trabalho.
Para obter orientações sobre como exportar outras salas e áreas de trabalho, consulte Configurar edifícios e pisos, configuração manual.
Opção 2
Assim que a sala e as informações da área de trabalho geradas pela Opção 1 forem validadas, deve remover colunas desnecessárias conforme descrito em Configurar edifícios e pisos e guardá-lo como um novo ficheiro CSV. Agora, está pronto para voltar a escrever estas informações no seu Diretório de Places com a Opção 2.
Todos os novos edifícios, pisos ou secções encontrados no ficheiro CSV são adicionados ao seu diretório de Places e as novas salas e locais de trabalho são subordinados a pisos/secções.
Pode dividir o trabalho ao criar, cidade ou qualquer outro critério. Esta abordagem permite-lhe carregar iterativamente ficheiros CSV mais pequenos que contenham um subconjunto de salas e locais de trabalho que pretende adicionar ao seu Diretório de Places. Sempre que carregar um novo ficheiro CSV, edifícios, pisos e secções que ainda não se encontram no seu diretório de Places, são adicionados à hierarquia.
Depois de carregar o ficheiro CSV, é gerado um ficheiro com o nome fileToImport-ImportResults.csv e guardado na mesma pasta. Este ficheiro documenta se foram encontrados problemas durante o carregamento. Nesta fase, fica disponível uma hierarquia completa de dados espaciais para serem utilizados por Microsoft Places no seu inquilino.
Carregar um ficheiro CSV faz com que os nomes dos Edifícios fiquem visíveis na experiência do Microsoft 365. Na prática, isto significa que os utilizadores podem ver e escolher estes edifícios em
Planos de trabalho (ou seja, horário de trabalho e localização do Outlook)
Presença no local de trabalho
outras experiências, conforme descrito no Microsoft Places descrição geral.
Importante
Certifique-se de que cada edifício, piso e secção estão escritos exatamente da mesma forma no ficheiro CSV e nos ficheiros CSV se os carregar iterativamente. As diferenças resultam na criação de edifícios, pisos ou secções adicionais.
Opção 3
Esta opção avançada permite-lhe rever o script do PowerShell que configura o diretório do Places antes de o executar. Com esta opção, o script do PowerShell é transferido para o seu computador, mas não é executado. A opção 3 pode ser útil se precisar de separar tarefas administrativas entre várias pessoas.
O script do PowerShell chama-sePlacesOnboardingScript.ps1 e é guardado na mesma pasta que o ficheiro CSV carregado. Tem de executar manualmente o script do PowerShell para configurar o Places Directory.
Observação
A descrição do cmdlet utiliza incorretamente o termo "importar" para a Opção 3, mas esta opção não cria nada no seu diretório de Places. Gera apenas o script que tem de executar manualmente.
Formatos de arquivo
Formato de ficheiro do ficheiro exportado (Opção 1)
| Nome da coluna | Descrição |
|---|---|
| InferredBuildingName | Microsoft Places tenta inferir (sugerir) o que acredita ser o nome do edifício para esta sala/área de trabalho, com base na propriedade de edifício da sala/áreas de trabalho e na lista de salas associadas. Esta coluna deve ser revista & atualizada com o valor correto antes de importar (Opção 2 ou 3). |
| InferredFloorName | Microsoft Places tenta inferir (sugerir) o que acredita ser o nome do piso desta sala/área de trabalho, com base na propriedade floorLabel da sala/áreas de trabalho e na lista de salas associadas. Esta coluna deve ser revista & atualizada com o valor correto antes de importar (Opção 2 ou 3). |
| InferredSectionName | Microsoft Places sugere o nome do piso (InferredFloorName) como o nome da secção das áreas de trabalho e deixa-o em branco para salas. Esta coluna deve ser revista & atualizada com o valor correto antes de importar (Opção 2 ou 3) |
| CurrentBuildingLabel | O valor atual da cadeia de carateres do conjunto de edifícios nos metadados da sala ou da área de trabalho |
| CurrentFloorNumber | O valor inteiro atual do piso definido nos metadados da sala ou da área de trabalho |
| CurrentFloorLabel | O valor atual da cadeia de carateres do floorLabel definido nos metadados da sala ou da área de trabalho |
| PrimarySmtpAddress | O endereço smtp da sala ou área de trabalho |
| Nome | O nome a apresentar da sala/área de trabalho |
| RoomList | A lista de salas associadas das salas/áreas de trabalho |
| ResourceType | Define se o recurso é uma Sala ou um Espaço (área de trabalho) |
| StreetAddress | O endereço da rua da sala/área de trabalho |
| Cidade | A cidade da sala/área de trabalho |
| StateOrProvince | O estado/província da sala/área de trabalho |
| CountryOrRegion | O país/região da sala/área de trabalho |
| Confidence | O nível de confiança no nome do edifício inferido e o nome do piso inferido |
Formato de ficheiro necessário para importação (Opção 2 e 3)
O ficheiro importado tem de ter apenas as quatro colunas seguintes:
| Nome da coluna | Descrição |
|---|---|
| InferredBuildingName | (obrigatório) Este nome é utilizado ao criar o edifício |
| InferredFloorName | (obrigatório) Este nome é utilizado ao criar o piso. |
| InferredSectionName | Este nome é utilizado ao criar a secção (uma zona ou bairro no chão). Este nome é necessário para áreas de trabalho, mas é opcional para salas. |
| PrimarySmtpAddress | (obrigatório) O endereço smtp da sala ou área de trabalho |