Condividi tramite


New-Place

Usare il cmdlet New-Place per creare edifici, pavimenti, sezioni o scrivanie all'interno della directory Places.

Nota

Per creare sale o aree di lavoro, è necessario continuare a usare il cmdlet New-Mailbox descritto qui.

Sintassi

Creazione

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

Pavimento

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-SortOrder]
 [-Tags]

Sezione

Una sezione è un raggruppamento di spazi all'interno di un piano, ad esempio un quartiere. Le scrivanie e le aree di lavoro devono essere padre di una sezione. Le camere possono anche essere facoltativamente padre di una sezione o possono essere direttamente padre di un piano.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

Scrivania

I desk sono un nuovo tipo di entità in Places, che rappresentano i singoli desk. Questi oggetti possono essere prenotabili o non prenotabili (impostazione predefinita).

Per rendere prenotabile una scrivania, è necessario creare una cassetta postale desk e associarla all'oggetto desk passando la cassetta postale Alias al Mailbox parametro di Set-PlaceV3. Si noti che, a differenza dei tipi room/area di lavoro, non viene eseguito il provisioning implicito delle scrivanie creando la sola cassetta postale. Inoltre, i metadati , ad esempio i Capacity campi o DisplayName , non vengono mantenuti sincronizzati con i metadati della cassetta postale. La cassetta postale è necessaria principalmente solo per il motore di prenotazione e i metadati vengono letti da Places Directory.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]

Descrizione

Places dipende da una gerarchia completamente configurata tra le camere/aree di lavoro, i pavimenti e gli edifici. Dopo aver creato edifici e pavimenti, è possibile collegarli usando parentId. Una stanza dovrebbe avere un pavimento o una sezione padre. Un'area di lavoro o una scrivania deve avere una sezione padre. Una sezione deve avere un piano padre. Un piano dovrebbe avere un edificio padre.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. È necessario avere il ruolo Exchange Amministrazione o il ruolo Places TenantPlacesManagement.

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.

Esempi

Esempio 1

In questo esempio vengono creati un nuovo edificio e un piano all'interno di tale edificio.

New-Place -Type Building -Name 'Building 3'

Dopo aver creato correttamente l'edificio 3, leggere il relativo PlaceId da usare quando si imposta ParentId sui pavimenti.

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

Esempio 2

In questo esempio viene creato un nuovo edificio con informazioni sugli indirizzi.

New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

Esempio 3

In questo esempio viene creato un nuovo edificio con collegamenti alle risorse.

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

Esempio 4

In questo esempio viene creata una sezione padre di un piano, quindi viene creata una cassetta postale da tavolo e assegnata a un'entità desk esistente. Si noti che il modulo è ExchangeOnlineManagement installato ed eseguire il Connect-ExchangeOnline cmdlet prima di eseguire questo script di esempio.

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias

Parametri

-Città

Il parametro City consente di specificare la città dell'edificio. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). La lunghezza massima è di 200 caratteri.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-CountryOrRegion

Il parametro CountryOrRegion consente di specificare il paese o l'area geografica dell'edificio. Un valore valido è un codice paese con due lettere ISO 3166-1 valido (ad esempio AU per l'Australia) o il nome descrittivo corrispondente per il paese (che potrebbe essere diverso dal nome breve ufficiale dell'agenzia di manutenzione ISO 3166).

Un riferimento per i codici paese a due lettere è disponibile nell'elenco codici paese.

Le informazioni sull'indirizzo vengono usate dalla pagina esplora Places per visualizzare gli edifici nelle vicinanze.

Attributo Descrizione
Digitare: CountryInfo
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-Label

Il parametro Label consente di specificare un'etichetta descrittiva per il luogo. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). La lunghezza massima è di 200 caratteri.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Vero
Accettare caratteri jolly: Falso

-GeoCoordinates

Il parametro GeoCoordinates specifica la posizione dell'edificio in coordinate di latitudine, longitudine e (facoltativamente) altitudine. Un valore valido per questo parametro usa uno dei formati seguenti:

  • Latitudine e longitudine: ad esempio, "47.644125;-122.122411"
  • Latitudine, longitudine e altitudine: ad esempio, "47.644125;-122.122411; 161.432"

Nota

Se i separatori di periodo non funzionano per te, usa invece le virgole.

Attributo Descrizione
Digitare: GeoCoordinates
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-DisplayName

Il parametro DisplayName consente di specificare il nome visualizzato della posizione. La lunghezza massima è di 200 caratteri.

Il nome visualizzato di un edificio è visibile:

  • In Outlook, quando gli utenti configurano le ore lavorative e la posizione, sono in grado di selezionare un edificio.
  • In Places pagina Esplora che mostra chi altro si trova nello stesso edificio, negli edifici vicini e altro ancora.
  • In Places Finder, come filtro durante la ricerca di una sala conferenze o di un'area di lavoro.

Il nome visualizzato di un piano è visibile in Places Finder come filtro durante la ricerca di una sala conferenze o di un'area di lavoro.

Attributo Descrizione
Digitare: Stringa
Valore predefinito: Nessuno
Obbligatorio: Vero
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-ParentId

Il parametro ParentId specifica l'ID di un oggetto Place nella gerarchia di percorsi padre in Microsoft Places.

  • Una stanza dovrebbe avere un pavimento o una sezione padre.
  • Un'area di lavoro o una scrivania deve avere una sezione padre.
  • Una sezione deve avere un piano padre.
  • Un piano dovrebbe avere un edificio padre.

Nota

Se è necessaria la compatibilità con le versioni precedenti di Outlook Roomfinder, assicurarsi di aggiornare anche le proprietà "Floor"/"FloorLabel", in parallelo con l'elemento padre della stanza all'entità floor. Places Finder usa la nuova gerarchia mentre Outlook Roomfinder continua a usare gli oggetti legacy "Floor" e "FloorLabel". È anche necessario assicurarsi che la sala sia associata a un elenco room, come illustrato qui Configurare le sale e le aree di lavoro per Room Finder in Outlook.You need also need to sure the room is associated with a Roomlist, as documented here Configure rooms and workspaces for Room Finder in Outlook.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-PostalCode

Il parametro PostalCode specifica il codice postale dell'edificio. La lunghezza massima è di 200 caratteri.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

Il parametro ResourceLinks specifica i collegamenti esterni o gli ID dell'app Teams che devono essere associati a questo edificio, ad esempio un menu da pranzo, un collegamento ai servizi o un'app Teams per la gestione dei visitatori. Per altre informazioni su come configurare i servizi in Places, vedere Servizi in Places.

Il valore deve essere fornito come matrice di collegamenti, come illustrato nell'esempio 4. Ogni collegamento deve contenere le proprietà seguenti: Nome, Valore e Tipo.  Ad esempio, un collegamento verrà scritto come @{name="TestLink"; value="https://contoso.com/"; type="Url"}.

  • Nome
    • Questa stringa viene usata per mostrare come viene visualizzato il collegamento o il nome dell'app nell'app Places.
    • La lunghezza massima è di 200 caratteri.
  • Valore
    • Questo valore deve essere un collegamento URL o un ID app teams. Gli ID dell'app Teams sono disponibili nella pagina Dettagli app dell'app nella pagina Gestisci app nell'interfaccia di amministrazione di Teams.
    • La lunghezza massima è di 1000 caratteri.
  • Il tipo deve essere uno dei tipi supportati:
    • URL: indica che si tratta di un collegamento url.
    • MetaOsApp: indica che questo collegamento è un'app Teams.

Nota

L'intero set viene sostituito. Per aggiungere o rimuovere un valore, assicurarsi di includere i valori precedenti che devono essere resi persistenti.

Attributo Descrizione
Digitare: ResourceLink[]
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-SortOrder

Il parametro SortOrder consente di specificare l'ordinamento del piano. Ad esempio, un piano potrebbe essere denominato "Lobby" con un ordinamento pari a 0 per visualizzare questo piano prima negli elenchi ordinati.

Attributo Descrizione
Digitare: System.Int32
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-Stato

Il parametro State consente di specificare lo stato o la provincia dell'edificio. La lunghezza massima è di 200 caratteri.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-Via

Il parametro Street specifica l'indirizzo fisico dell'edificio. La lunghezza massima è di 200 caratteri.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-Tag

Il parametro Tags consente di specificare altre funzionalità della sala, ad esempio dettagli come il tipo di visualizzazione o il tipo di mobili. Attualmente non è presente alcuna lunghezza massima.

È possibile specificare più etichette separate da virgole. Se le etichette contengono spazi, racchiudere i valori tra virgolette: "Label 1","Label 2",..."Label N".

Nota

L'intero set viene sostituito all'aggiornamento. Per aggiungere o rimuovere un valore, assicurarsi di includere i valori precedenti che devono essere resi persistenti.

Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Falso
Accettare l'input della pipeline: Falso
Accettare caratteri jolly: Falso

-Digitare

Il parametro Type consente di specificare il tipo di posizione da creare. I valori validi sono:

  • Creazione
  • Pavimento
  • Sezione
  • Scrivania
Attributo Descrizione
Digitare: Stringa
Posizione: Denominato
Valore predefinito: Nessuno
Obbligatorio: Vero
Accettare l'input della pipeline: Vero
Accettare caratteri jolly: Falso