Initialize-Places

Il Initialize-Places cmdlet è un'esperienza New-Placesemplificata e di creazione rapida che può essere usata al posto dei cmdlet e Set-PlaceV3 dei cmdlet.

Initialize-Places analizza le stanze e le aree di lavoro esistenti nel tenant e deduce i nomi di edifici, piani e sezioni. Consente di rivedere e modificare le informazioni dedotte prima di creare una gerarchia di edifici, piani, sezioni, stanze e spazi di lavoro nella Places Directory.

In questa pagina vengono fornite informazioni dettagliate sulla sintassi e sulle opzioni del cmdlet. Una guida dettagliata per l'uso di questo cmdlet è disponibile in Configurare edifici e piani.

Importante

Utilizzare la versione più recente del modulo PowerShell di Microsoft Places. Se il modulo non è installato o se Initialize-Places non visualizza le opzioni documentate in questa pagina, eseguire:
Install-Module -Name MicrosoftPlaces -Force

Quindi chiudere e riaprire PowerShell prima di connettersi a Microsoft Places.

Sintassi

In esecuzione Initialize-Places viene visualizzato un elenco di opzioni:

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.

Attenzione

Nel cmdlet di PowerShell potrebbero essere presenti altri parametri, ma al momento non sono supportati. Non è consigliabile utilizzare parametri non documentati in questa pagina.

Opzione 1

Questa opzione analizza le stanze e le aree di lavoro configurate nel tenant e genera un file CSV denominato ResourceAccountsMapped.csv. Questo file CSV contiene altri dati, ad esempio nomi di edifici, piani e sezioni, dedotti dai dati di Rooms, Workplace ed RoomList.

Il file CSV include solo le sale e le aree di lavoro disponibili in Exchange Online associate a un RoomList e non sono ancora associate a un piano o a una sezione in Places Directory.

Ad esempio:

• I Places non associati ad alcuna RoomList non vengono inclusi nel file CSV. Queste sale non sono visibili in Ricerca sala e sono escluse per impostazione predefinita per garantire che non vengano visualizzate in Places Finder a meno che non vengano aggiunte manualmente in un secondo momento.

• Sono inclusi i Places associati a due o più RoomList. Tuttavia, il nome dell'edificio dedotto viene lasciato vuoto. È necessario scrivere il nome corretto dell'edificio.

• I Places già associati a un piano o a una sezione non sono inclusi nel CSV. È possibile eseguire lo script in modo iterativo quando vengono aggiunte nuove sale e aree di lavoro in Exchange Online e il file CSV di output deve includere solo le nuove sale e aree di lavoro.

Per indicazioni su come esportare altri gruppi e aree di lavoro, vedere Configurare edifici e piani, configurazione manuale.

Opzione 2

Una volta convalidate le informazioni sulla stanza e sull'area di lavoro generate dall'opzione 1, è necessario rimuovere le colonne non necessarie come descritto in Configurare edifici e piani e salvarle come nuovo file CSV. Ora sei pronto per scrivere queste informazioni nella tua directory di Places utilizzando l'opzione 2.

Qualsiasi nuovo edificio, piano o sezione trovata nel file CSV viene aggiunta alla tua directory di Places e le nuove stanze e luoghi di lavoro sono parenti di piani/sezioni.

È possibile suddividere il lavoro in base all'edificio, alla città o a qualsiasi altro criterio. Questo approccio consente di caricare in modo iterativo file CSV più piccoli che contengono un sottoinsieme di sale e luoghi di lavoro da aggiungere alla directory di Places. Ogni volta che carichi un nuovo file CSV, gli edifici, i piani e le sezioni che non sono ancora nella tua Cartella Places vengono aggiunti alla gerarchia.

Dopo aver caricato il file CSV, viene generato un file denominato fileToImport-ImportResults.csv che viene salvato nella stessa cartella. Questo file documenta se si sono verificati problemi durante il caricamento. In questa fase, una gerarchia completa di dati spaziali diventa disponibile per l'uso da parte di Microsoft Places nel tenant.

Il caricamento di un file CSV comporta la visualizzazione dei nomi degli edifici nell'esperienza Microsoft 365. In pratica, ciò significa che gli utenti possono vedere e scegliere questi edifici in

• Piani di lavoro, ovvero l'orario di lavoro e la posizione di Outlook.

• Presenza sul posto di lavoro

• altre esperienze, come descritto in Panoramica di Microsoft Places.

Importante

Assicurarsi che ogni edificio, piano e sezione sia scritto esattamente allo stesso modo nel file CSV e nei file CSV se vengono caricati in modo iterativo. Le differenze comportano la creazione di ulteriori edifici, piani o sezioni.

Opzione 3

Questa opzione avanzata consente di esaminare lo script di PowerShell che configura la directory di Places prima di eseguirlo. Con questa opzione, lo script di PowerShell viene scaricato nel computer ma non eseguito. L'opzione 3 può essere utile se è necessario separare le attività amministrative tra più persone.

Lo script di PowerShell viene denominato PlacesOnboardingScript.ps1 e viene salvato nella stessa cartella del file CSV caricato. Per configurare la directory di Places, è necessario eseguire manualmente lo script PowerShell.

Nota

La descrizione del cmdlet usa in modo errato il termine "importare" per l'opzione 3, ma questa opzione non crea nulla nella directory di Places. Genera solo lo script che devi eseguire manualmente.

Formati di file

Formato del file esportato (opzione 1)

Nome colonna	Descrizione
InferredBuildingName	Microsoft Places tenta di dedurre (suggerire) quello che ritiene sia il nome dell'edificio per questa sala/area di lavoro, in base alla proprietà dell'edificio della sala/area di lavoro e all'elenco delle sale associato. Questa colonna deve essere esaminata & aggiornata con il valore corretto prima dell'importazione (opzione 2 o 3).
InferredFloorName	Microsoft Places tenta di dedurre (suggerire) quello che ritiene sia il nome del piano per questa stanza/area di lavoro, in base alla proprietà floorLabel della sala/area di lavoro e all'elenco delle sale associato. Questa colonna deve essere esaminata & aggiornata con il valore corretto prima dell'importazione (opzione 2 o 3).
InferredSectionName	Microsoft Places suggerisce il nome del piano (InferredFloorName) come nome della sezione per le aree di lavoro e lo lascia vuoto per le stanze. Questa colonna deve essere esaminata & aggiornata con il valore corretto prima dell'importazione (opzione 2 o 3)
CurrentBuildingLabel	Valore stringa corrente del set di elementi di costruzione nei metadati del gruppo o dell'area di lavoro
CurrentFloorNumber	Valore intero corrente del piano impostato nei metadati della stanza o dell'area di lavoro
CurrentFloorLabel	Valore stringa corrente di floorLabel impostato sui metadati della stanza o dell'area di lavoro
PrimarySmtpAddress	Indirizzo SMTP della stanza o dell'area di lavoro
Nome	Nome visualizzato della sala/area di lavoro
Elenco delle stanze	Elenco delle sale o delle aree di lavoro associate
ResourceType	Definisce se la risorsa è una stanza o uno spazio (area di lavoro)
IndirizzoStradale	Indirizzo della stanza o dell'area di lavoro
Città	La città della stanza/area di lavoro
StatoOrProvincia	Stato/provincia del gruppo/area di lavoro
CountryOrRegion	Paese/area geografica della stanza/area di lavoro
Fiducia	Livello di confidenza nel nome dell'edificio dedotto e nel nome del piano dedotto

Formato di file necessario per l'importazione (opzioni 2 e 3)

Il file importato deve avere solo le quattro colonne seguenti:

Nome colonna	Descrizione
InferredBuildingName	(obbligatorio) Questo nome viene utilizzato durante la creazione dell'edificio
InferredFloorName	(obbligatorio) Questo nome viene utilizzato durante la creazione del pavimento.
InferredSectionName	Questo nome viene utilizzato quando si crea la sezione (una zona o un vicinato sul pavimento). Questo nome è obbligatorio per le aree di lavoro, ma è facoltativo per le stanze.
PrimarySmtpAddress	(obbligatorio) Indirizzo SMTP della stanza o dell'area di lavoro