Initialize-Places

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

Initialize-Places analizza le sale esistenti e le aree di lavoro nel tenant e deduce i nomi di edifici, piani e sezioni. Consente di verificare, modificare queste informazioni e quindi di creare una gerarchia completa di edifici > , locali > e aree di lavoro nel tenant. Questa gerarchia viene talvolta definita directory Places.

Questa pagina fornisce informazioni dettagliate sulla sintassi dei cmdlet e sulle opzioni. Una guida dettagliata all'uso di questo cmdlet è disponibile in Configurare edifici e pavimenti.

Importante

Il 14 novembre 2024 sono stati apportati aggiornamenti importanti al modulo cmdlet MicrosoftPlaces. Se si è aggiunto al programma di anteprima prima di tale data, ottenere la versione più recente del modulo eseguendo Run Install-Module -Name MicrosoftPlaces -Force, quindi chiudere e riavviare PowerShell.

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

È possibile trovare parametri aggiuntivi nel cmdlet di PowerShell, ma questi non sono attualmente supportati. Non è consigliabile usare alcun parametro non documentato in questa pagina.

Opzione 1

Questa opzione analizza le sale 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 rooms, workplace e RoomList.

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

Ad esempio:

• Places non associati ad alcun elemento RoomList non sono inclusi nel csv. Queste camere non sono visibili nel finder della stanza e vengono escluse per impostazione predefinita per assicurarsi che non vengano visualizzate in Places Finder a meno che non vengano aggiunte manualmente in un secondo momento.

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

• Places già padre di un piano o una sezione non è inclusa 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 le aree di lavoro.

Per indicazioni su come esportare altre stanze e aree di lavoro, vedere Configurare edifici e pavimenti, configurazione manuale.

Opzione 2

Dopo aver convalidato la sala e le informazioni sull'area di lavoro generate dall'opzione 1, è necessario rimuovere le colonne non necessarie come indicato in Configurare edifici e pavimenti e salvarle come nuovo file CSV. È ora possibile riscrivere queste informazioni nella directory Places usando l'opzione 2.

Qualsiasi nuovo edificio, piano o sezione presente nel file CSV viene aggiunto alla directory Places e le nuove stanze e le nuove aree di lavoro sono collegate a 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 stanze e luoghi di lavoro da aggiungere alla directory Places. Ogni volta che si carica un nuovo file CSV, gli edifici, i pavimenti e le sezioni non ancora presenti nella directory Places vengono aggiunti alla gerarchia.

Dopo aver caricato il file CSV, viene generato un file denominato fileToImport-ImportResults.csv e salvato nella stessa cartella. Questo file indica 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 di Microsoft 365. In pratica, questo significa che gli utenti possono vedere e scegliere questi edifici in

• Piani di lavoro (ovvero orario di lavoro di Outlook e località)

• Presenza sul posto di lavoro

• altre esperienze, come descritto in Microsoft Places panoramica.

Importante

Assicurarsi che ogni edificio, piano e sezione siano digitati esattamente nello stesso modo nel file CSV e nei file CSV se li si carica in modo iterativo. Le differenze determinano la creazione di altri edifici, pavimenti o sezioni.

Opzione 3

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

Lo script di PowerShell viene chiamato PlacesOnboardingScript.ps1 e viene salvato nella stessa cartella del file CSV caricato. È necessario eseguire manualmente lo script di PowerShell per configurare la directory Places.

Nota

La descrizione del cmdlet usa erroneamente il termine "import" per l'opzione 3, ma questa opzione non crea nulla nella directory Places. Genera solo lo script che è necessario eseguire manualmente.

Formati di file

Formato file del file esportato (opzione 1)

Nome colonna	Descrizione
InferredBuildingName	Microsoft Places tenta di dedurre (suggerire) il nome dell'edificio per questa stanza/area di lavoro, in base alla proprietà dell'edificio della sala/area di lavoro e all'elenco di 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) il nome del pavimento per questa stanza/area di lavoro, in base alla proprietà floorLabel della sala/area di lavoro e all'elenco di stanze 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 dell'insieme di compilazione nei metadati della sala o dell'area di lavoro
CurrentFloorNumber	Valore intero corrente del piano impostato sui metadati della sala o dell'area di lavoro
CurrentFloorLabel	Valore stringa corrente di floorLabel impostato sui metadati della sala o dell'area di lavoro
PrimarySmtpAddress	Indirizzo smtp della sala o dell'area di lavoro
Nome	Nome visualizzato della sala/area di lavoro
RoomList	Elenco delle sale associate delle sale/aree di lavoro
ResourceType	Definisce se la risorsa è una sala o uno spazio (area di lavoro)
StreetAddress	Indirizzo della stanza/area di lavoro
Città	La città della stanza/area di lavoro
StateOrProvince	Stato/provincia della sala/area di lavoro
CountryOrRegion	Paese/area geografica della sala/area di lavoro
Fiducia	Livello di attendibilità nel nome dell'edificio dedotto e nel nome del piano dedotto

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

Il file importato deve avere solo le quattro colonne seguenti:

Nome colonna	Descrizione
InferredBuildingName	(obbligatorio) Questo nome viene usato durante la creazione dell'edificio
InferredFloorName	(obbligatorio) Questo nome viene usato durante la creazione del pavimento.
InferredSectionName	Questo nome viene usato durante la creazione della sezione (una zona o un quartiere sul pavimento). Questo nome è necessario per le aree di lavoro, ma è facoltativo per le stanze.
PrimarySmtpAddress	(obbligatorio) Indirizzo smtp della sala o dell'area di lavoro