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 |
-ResourceLinks
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 |