Set-PlaceV3
Usare il cmdlet Set-PlaceV3 per aggiornare i metadati relativi a stanze, aree di lavoro, pavimenti o edifici all'interno della directory Places.
Nota
- Aggiornamenti nelle sale conferenze & aree di lavoro possono richiedere fino a 24 ore per riflettere. Se è necessario eseguire l'onboarding di più sale e aree di lavoro, è consigliabile usare
Initialize-Places, che è in grado di forzare la riflessione immediata delle modifiche. - Il Set-UserPhoto è stato deprecato nell'aprile 2024. Si sta lavorando per aggiungere un parametro a questo cmdlet per impostare una foto in stanze e aree di lavoro quando si usa Set-PlaceV3. Nel frattempo, seguire queste istruzioni per impostare la foto in una stanza o in un'area di lavoro.
Sintassi
Creazione
Set-PlaceV3
[-Identity]
[-DisplayName]
[-Label]
[-IsWheelChairAccessible]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-ResourceLinks]
[-Tags]
Pavimento
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-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.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Tags]
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 di sala/area di lavoro, il provisioning implicito delle scrivanie non viene eseguito 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 verranno letti da Places Directory.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
Sala o area di lavoro
Set-PlaceV3 supporta i parametri di posizione legacy già esposti nel cmdlet di Exchange Set-Place. Tuttavia, una volta che una sala è collegata a un piano/edificio usando il -ParentId parametro , le informazioni sulla posizione (Street, Citye così via) devono essere gestite nell'edificio anziché nella sala o nell'area di lavoro.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Capacity]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-Building]
[-Floor]
[-FloorLabel]
[-Tags]
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 viene impostata la gerarchia di directory per una stanza, un piano e un edificio.
In questo esempio, il PlaceId del pavimento è f12172b6-195d-4e6e-8f4f-eb72e41de99a e il PlaceId dell'edificio è daa2f89b-75c4-4eb7-adcc-ff24923338d.
Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d
Esempio 2
In questo esempio viene aggiornato l'indirizzo di un edificio.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052
Esempio 3
In questo esempio vengono aggiornate le geocoordinate di un edificio.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"
Esempio 4
In questo esempio vengono aggiornati i collegamenti alle risorse per un edificio con collegamenti alle risorse. L'intero set viene sostituito all'aggiornamento. Per aggiungere o rimuovere un valore, assicurarsi di includere i valori precedenti che devono essere resi persistenti.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}
Esempio 5
Questo esempio crea una cassetta postale da tavolo e la assegna a un'entità desk esistente. Si noti che è necessario avere installato ExchangeOnlineManagement il modulo ed eseguire il Connect-ExchangeOnline cmdlet prima di eseguire quanto segue:
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
Parametri
-Identity
Il parametro identity consente di specificare la posizione da aggiornare. È possibile usare qualsiasi valore che identifichi in modo univoco una posizione.
Ad esempio, per le posizioni basate su una cassetta postale (sale conferenze e aree di lavoro):
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Nome distinto canonico
- GUID
Ad esempio, per le posizioni non basate su una cassetta postale (edifici, pavimenti, sezioni e scrivanie):
- Nome
- GUID
| Attributo | Descrizione |
|---|---|
| Digitare: | RecipientIdParameter |
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Vero |
| Accettare caratteri jolly: | Falso |
-AudioDeviceName, -DisplayDeviceName e VideoDeviceName
Questi parametri specificano il nome dei dispositivi audio, display e video nella stanza. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Il valore predefinito è vuoto ($null). Per indicare che questa sala non dispone di dispositivi audio, display o video, usare il valore $null per il parametro .
| Attributo | Descrizione |
|---|---|
| Digitare: | Stringa |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-Edificio
Importante
Il parametro di compilazione è deprecato e fornito qui solo per la compatibilità con le versioni precedenti. Le informazioni sulla compilazione verranno lette dall'entità Building presente nella catena padre della sala o dell'area di lavoro.
Il parametro Building consente di specificare il nome dell'edificio o il numero di edificio in cui si trova la stanza. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Attributo | Descrizione |
|---|---|
| Digitare: | Stringa |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-Capacità
Il parametro Capacity consente di specificare la capacità della sala. Un valore valido è un numero intero.
| Attributo | Descrizione |
|---|---|
| Digitare: | System.Int32 |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-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.
È consigliabile gestire i dati sulla posizione nell'edificio anziché nella sala/area di lavoro. C'è una gerarchia tra le stanze -> pavimenti -> edifici e le stanze ereditano gli attributi di posizione del loro edificio.
| 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.
È consigliabile gestire i dati sulla posizione nell'edificio anziché nella sala/area di lavoro. C'è una gerarchia tra le stanze -> pavimenti -> edifici e le stanze ereditano gli attributi di posizione del loro edificio.
| 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.
Per le sale e le aree di lavoro, il comando aggiorna il valore denominato -Label in Exchange Set-Place.
| Attributo | Descrizione |
|---|---|
| Digitare: | Stringa |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Vero |
| Accettare caratteri jolly: | Falso |
-DisplayDeviceName
Il parametro DisplayDeviceName consente di specificare il nome del dispositivo visualizzato nella sala. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Il valore predefinito è vuoto ($null). Per indicare che questa sala non dispone di un dispositivo di visualizzazione, usare il valore $null per questo parametro.
| Attributo | Descrizione |
|---|---|
| Digitare: | Stringa |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-FloorLabel
Il parametro FloorLabel specifica un'etichetta descrittiva per il pavimento. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Attributo | Descrizione |
|---|---|
| Digitare: | Stringa |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-Pavimento
Il parametro Floor consente di specificare l'ordinamento del pavimento all'interno di un determinato edificio.
| Attributo | Descrizione |
|---|---|
| Digitare: | System.Int32 |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| 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"
Se i separatori di periodo non funzionano per te, usa invece le virgole.
È consigliabile gestire i dati sulla posizione nell'edificio anziché nella sala/area di lavoro. C'è una gerarchia tra le camere -> piani -> edifici, e la stanza erediterà gli attributi di posizione del loro edificio.
| Attributo | Descrizione |
|---|---|
| Digitare: | GeoCoordinates |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-IsWheelChairAccessible
Il parametro IsWheelChairAccessible consente di specificare se il posto è accessibile alle sedie a rotelle. I valori validi sono:
- $true: Il posto è accessibile alle sedie a rotelle.
- $false: Il posto non è accessibile alle sedie a rotelle. Questo è il valore predefinito.
| Attributo | Descrizione |
|---|---|
| Digitare: | Booleano |
| Posizione: | Denominato |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Falso |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-MTREnabled
Nota
Attualmente, questo parametro è solo informativo e non comporta funzionalità aggiuntive.
Il parametro MTREnabled identifica la sala come configurata con un sistema di sala di Microsoft Teams. È possibile aggiungere i sistemi room di Teams come origini audio nelle riunioni di Teams che coinvolgono la sala. I valori validi sono:
- $true: la sala dispone di un sistema di sala Teams. È possibile aggiungere il sistema di sala teams alle riunioni di Microsoft Teams quando si seleziona di partecipare a una riunione con audio della sala.
- $false: la stanza non dispone di un sistema di sala teams. Gli utenti possono partecipare alle riunioni di Teams usando l'audio del PC o del dispositivo mobile anziché l'audio della sala. Questo è il valore predefinito.
Per altre informazioni sui Microsoft Teams Rooms, vedere Microsoft Teams Rooms.
| Attributo | Descrizione |
|---|---|
| Digitare: | Booleano |
| 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. Set-PlaceV3 può aggiornare solo il nome delle posizioni che non hanno un indirizzo SMTP associato, ad esempio edifici e pavimenti. Per aggiornare il nome visualizzato di una posizione con un indirizzo SMTP associato, ad esempio sale conferenze e aree di lavoro, usare il cmdlet exchange Set-Mailbox.
| 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 userà la nuova gerarchia mentre Outlook Roomfinder cotinue userà gli oggetti legacy "Floor" e "FloorLabel". Sarà 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.
| 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.
| 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 1.000 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 verrà sostituito all'aggiornamento. Per aggiungere o rimuovere un valore, assicurarsi di includere i valori precedenti che devono essere resi persistenti.
| Attributo | Descrizione |
|---|---|
| Digitare: | Link[] |
| 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.
È consigliabile gestire i dati sulla posizione nell'edificio anziché nella sala/area di lavoro. Esiste una gerarchia tra le camere -> piani -> edifici e la stanza eredita gli attributi di posizione del loro edificio.
| 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.
È consigliabile gestire i dati sulla posizione nell'edificio anziché nella sala/area di lavoro. C'è una gerarchia tra le stanze -> pavimenti -> edifici e le stanze ereditano gli attributi di posizione del loro edificio.
| 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 funzionalità aggiuntive della sala, ad esempio dettagli come il tipo di visualizzazione o il tipo di arredamento. 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 verrà 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 |
Risoluzione dei problemi
Viene visualizzato un errore relativo alle autorizzazioni negate.
Set-PlaceV3 richiede uno dei ruoli seguenti: TenantPlacesManagement, GlobalAdmin o MailRecepients. Poiché i ruoli possono essere assegnati in modi diversi, i modi supportati per assegnare le autorizzazioni dei ruoli sono i seguenti:
- Se l'autorizzazione viene assegnata tramite Exchange Amministrazione Center (che supporta solo le autorizzazioni permanenti), non si dovrebbero verificare problemi con l'uso dei cmdlet Places. Non è previsto che venga visualizzato un errore di autorizzazione negata.
- Se l'autorizzazione viene assegnata tramite Entra direttamente all'utente (come ruolo permanente o temporaneo), non dovrebbero verificarsi problemi con l'uso dei cmdlet Places. Non è previsto che venga visualizzato un errore di autorizzazione negata. Tuttavia, potrebbe verificarsi un ritardo nella sincronizzazione tra Entra ed Exchange.
- Se l'autorizzazione viene assegnata tramite Entra a un gruppo in Entra, di cui l'utente fa parte, questo non è supportato da Exchange e il gruppo di ruoli-through non verrà rispettato. I cmdlet di Exchange e i cmdlet Places avranno entrambi esito negativo con autorizzazione negata. Questo comportamento previsto è descritto qui.
È stato assegnato un ParentId a una risorsa, ma non è ancora visualizzato in Places Finder.
La correlazione tra la risorsa e il relativo piano padre può richiedere fino a 24 ore nelle esperienze Places. Stiamo lavorando per eliminare questo ritardo.
Ricerca per categorie impostare una foto su una risorsa?
Il Set-UserPhoto è stato deprecato nell'aprile 2024. Si sta lavorando per aggiungere un parametro a questo cmdlet per impostare una foto in stanze e aree di lavoro quando si usa Set-PlaceV3. Nel frattempo, segui queste istruzioni per impostare la foto in una stanza o in un'area di lavoro.
Non è attualmente possibile impostare foto su un edificio o su un piano.