Set-PlaceV3
Utilize o cmdlet Set-PlaceV3 para atualizar metadados sobre as suas salas, áreas de trabalho, pisos ou edifícios no seu diretório Places.
Observação
- Atualizações a salas de conferência & áreas de trabalho podem demorar até 24 horas a refletir. Se precisar de integrar várias salas e áreas de trabalho, recomendamos a utilização
Initialize-Placesde , que é capaz de forçar as alterações a refletir imediatamente. - A Set-UserPhoto foi preterida em abril de 2024. Estamos a trabalhar para adicionar um parâmetro a este cmdlet para definir uma fotografia em salas e áreas de trabalho ao utilizar Set-PlaceV3. Entretanto, siga estas instruções para definir a fotografia numa sala ou área de trabalho.
Sintaxe
Compilando
Set-PlaceV3
[-Identity]
[-DisplayName]
[-Label]
[-IsWheelChairAccessible]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-ResourceLinks]
[-Tags]
Andar
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-SortOrder]
[-Tags]
Seção
Uma secção é um agrupamento de espaços num piso, por exemplo, um bairro. As secretárias e as áreas de trabalho têm de ser parentadas para uma secção. Opcionalmente, as salas também podem ser parentadas para uma secção ou podem ser diretamente parentadas para um piso.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Tags]
Secretária
As secretárias são um novo tipo de entidade no Places, que representam secretárias individuais. Estes objetos podem ser reserváveis ou não reserváveis (predefinição).
Para tornar uma secretária reservável, tem de criar uma caixa de correio de Secretária e associá-la ao objeto de secretária ao passar a caixa de correio Alias para o Mailbox parâmetro de Set-PlaceV3. Tenha em atenção que, ao contrário dos tipos de Sala/Área de Trabalho, as secretárias não são implicitamente aprovisionadas através da criação da caixa de correio. Além disso, os metadados (como os Capacity campos ou DisplayName ) não são mantidos em sincronização com os metadados da caixa de correio. A caixa de correio é essencialmente necessária apenas para o motor de reserva e os metadados serão lidos a partir do Places Directory.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
Sala ou Área de Trabalho
Set-PlaceV3 suporta parâmetros de localização legados já expostos no cmdlet do Exchange Set-Place. No entanto, assim que uma sala estiver ligada a um piso/edifício utilizando o parâmetro, as -ParentId informações de localização (Street, City, etc.) devem ser geridas no Edifício e não na sala ou área de trabalho.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Capacity]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-Building]
[-Floor]
[-FloorLabel]
[-Tags]
Descrição
Places depende de uma hierarquia totalmente configurada entre os seus quartos/áreas de trabalho, pisos e edifícios. Assim que os edifícios e pisos forem criados, pode ligá-los através de parentId. Uma sala deve ter um piso ou secção principal. Uma área de trabalho ou secretária deve ter uma secção principal. Uma secção deve ter um piso principal. Um piso deve ter um edifício principal.
Para executar esse cmdlet, você precisa ter permissões. Tem de ter a função exchange Administração ou a função Places TenantPlacesManagement.
Cuidado
Poderá encontrar parâmetros adicionais no cmdlet do PowerShell, mas estes não são atualmente suportados. Não é recomendado utilizar qualquer parâmetro que não esteja documentado nesta página.
Exemplos
Exemplo 1
Este exemplo configura a hierarquia de diretórios para uma sala, piso e edifício.
Neste exemplo, o PlaceId do piso é f12172b6-195d-4e6e-8f4f-eb72e41de99a e o PlaceId do edifício é 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
Exemplo 2
Este exemplo atualiza o endereço de um edifício.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052
Exemplo 3
Este exemplo atualiza os geocoordinados de um edifício.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"
Exemplo 4
Este exemplo atualiza as ligações de recursos de um edifício com ligações de recursos. Todo o conjunto é substituído na atualização. Para adicionar ou remover um valor, certifique-se de que inclui valores anteriores que devem ser persistentes.
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}
Exemplo 5
Este exemplo cria uma caixa de correio de secretária e atribui-a a uma entidade de secretária existente. Tenha em atenção que tem de ter instalado ExchangeOnlineManagement o módulo e executado o Connect-ExchangeOnline cmdlet antes de executar o seguinte:
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
Parâmetros
-Identidade
O parâmetro de identidade especifica o local que pretende atualizar. Pode utilizar qualquer valor que identifique exclusivamente um local.
Por exemplo, para locais baseados numa caixa de correio (salas de conferência e áreas de trabalho):
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Por exemplo, para locais que não se baseiam numa caixa de correio (edifícios, pisos, secções e mesas):
- Nome
- GUID
| Atributo | Descrição |
|---|---|
| Tipo: | RecipientIdParameter |
| Posição: | 0 |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Verdadeiro |
| Aceitar carateres universais: | Falso |
-AudioDeviceName, -DisplayDeviceName e VideoDeviceName
Estes parâmetros especificam o nome dos dispositivos de áudio, visualização e vídeo na sala. Se o valor contiver espaços, coloque-o entre aspas (").
O valor padrão é em branco ($null). Para indicar que esta sala não tem nenhum dispositivo de áudio, visualização ou vídeo, utilize o valor $null para o parâmetro .
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Edifício
Importante
O parâmetro de criação é preterido e fornecido aqui apenas para retrocompatibilidade. As informações de criação serão lidas a partir da entidade Edifício que está na cadeia principal da sala ou área de trabalho.
O parâmetro Edifício especifica o nome do edifício ou o número do edifício em que a sala se encontra. Se o valor contiver espaços, coloque-o entre aspas (").
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Capacidade
O parâmetro Capacidade especifica a capacidade da sala. O valor válido é um número inteiro.
| Atributo | Descrição |
|---|---|
| Tipo: | System.Int32 |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Cidade
O parâmetro Cidade especifica a cidade do edifício. Se o valor contiver espaços, coloque-o entre aspas ("). O comprimento máximo é de 200 carateres.
Recomendamos a gestão dos dados de localização no Edifício em vez da Sala/Área de Trabalho. Há uma hierarquia entre salas -> pisos -> edifícios e salas herdam os atributos de localização do respetivo Edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-CountryOrRegion
O parâmetro CountryOrRegion especifica o país ou região do edifício. Um valor válido é um código de país iso 3166-1 de duas letras válido (por exemplo, AU para a Austrália) ou o nome amigável correspondente para o país (que pode ser diferente do nome abreviado oficial da Iso 3166 Maintenance Agency).
Está disponível uma referência para códigos de país de duas letras na Lista de Códigos de País.
Recomendamos a gestão dos dados de localização no Edifício em vez da Sala/Área de Trabalho. Há uma hierarquia entre salas -> pisos -> edifícios e salas herdam os atributos de localização do respetivo Edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | CountryInfo |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Rótulo
O parâmetro Label especifica uma etiqueta descritiva para o local. Se o valor contiver espaços, coloque-o entre aspas ("). O comprimento máximo é de 200 carateres.
Para salas e áreas de trabalho, o comando atualiza o valor denominado -Label no Exchange Set-Place.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Verdadeiro |
| Aceitar carateres universais: | Falso |
-DisplayDeviceName
O parâmetro DisplayDeviceName especifica o nome do dispositivo de apresentação na sala. Se o valor contiver espaços, coloque-o entre aspas (").
O valor padrão é em branco ($null). Para indicar que esta sala não tem nenhum dispositivo de apresentação, utilize o valor $null para este parâmetro.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-FloorLabel
O parâmetro FloorLabel especifica uma etiqueta descritiva para o piso. Se o valor contiver espaços, coloque-o entre aspas (").
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Piso
O parâmetro Floor especifica a sequência de ordenação do piso dentro de um edifício específico.
| Atributo | Descrição |
|---|---|
| Tipo: | System.Int32 |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-GeoCoordinates
O parâmetro GeoCoordinates especifica a localização do edifício em latitude, longitude e (opcionalmente) coordenadas de altitude. Um valor válido para este parâmetro utiliza um dos seguintes formatos:
- Latitude e longitude: por exemplo, "47.644125;-122.122411"
- Latitude, longitude e altitude: por exemplo, "47.644125;-122.122411; 161.432"
Se os separadores de período não funcionarem para si, utilize vírgulas.
Recomendamos a gestão dos dados de localização no Edifício em vez da Sala/Área de Trabalho. Há uma hierarquia entre salas -> pisos -> edifícios, e salas herdarão os atributos de localização do seu Edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | GeoCoordinates |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-IsWheelChairAccessible
O parâmetro IsWheelChairAccessible especifica se o local é acessível para cadeiras de rodas. Os valores válidos são:
- $true: O local é acessível a cadeiras de rodas.
- $false: O lugar não é acessível a cadeiras de rodas. Esse é o valor padrão.
| Atributo | Descrição |
|---|---|
| Tipo: | Booliano |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-MTREnabled
Observação
Atualmente, este parâmetro é apenas informativo e não resulta em nenhuma funcionalidade adicional.
O parâmetro MTREnabled identifica a sala como configurada com um sistema de sala do Microsoft Teams. Pode adicionar sistemas de sala do Teams como origens de áudio em reuniões do Teams que envolvam a sala. Os valores válidos são:
- $true: A sala tem um sistema de salas Teams. Pode adicionar o sistema de sala do Teams às reuniões do Microsoft Teams ao selecionar participar numa reunião com áudio da sala.
- $false: A sala não tem um sistema de salas Teams. Os utilizadores podem participar em reuniões do Teams através do áudio do pc ou do dispositivo móvel em vez de utilizarem o áudio da sala. Esse é o valor padrão.
Para obter mais informações sobre Salas do Microsoft Teams, consulte Salas do Microsoft Teams.
| Atributo | Descrição |
|---|---|
| Tipo: | Booliano |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-DisplayName
O parâmetro DisplayName especifica o nome a apresentar do local. O comprimento máximo é de 200 carateres. Set-PlaceV3 só pode atualizar o nome dos locais que não tenham um endereço SMTP associado, como edifícios e pisos. Para atualizar o nome a apresentar de um local que tenha um endereço SMTP associado, como salas de conferência e áreas de trabalho, utilize o cmdlet exchange Set-Mailbox.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Valor predefinido: | Nenhum |
| Obrigatório: | Verdadeiro |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-ParentId
O parâmetro ParentId especifica o ID de um Local na hierarquia de localização principal no Microsoft Places. Uma sala deve ter um piso ou secção principal. Uma área de trabalho ou secretária deve ter uma secção principal. Uma secção deve ter um piso principal. Um piso deve ter um edifício principal.
Observação
Se precisar de retrocompatibilidade com o Outlook Roomfinder, certifique-se de que também atualiza as propriedades "Floor"/"FloorLabel", em paralelo com a parentalidade da sala para a entidade floor. Places Finder utilizará a nova hierarquia enquanto o Outlook Roomfinder cotinue para utilizar os objetos "Floor" e "FloorLabel" legados. Também terá de se certificar de que a sala está associada a uma Lista de Salas, conforme documentado aqui Configurar salas e áreas de trabalho para o Localizador de Salas no Outlook.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Código Postal
O parâmetro Código Postal especifica o código postal do edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-ResourceLinks
O parâmetro ResourceLinks especifica ligações externas ou IDs de aplicações do Teams que devem ser associados a este edifício, como um menu de refeições, uma ligação para serviços ou uma aplicação do Teams para gestão de visitantes. Para obter mais informações sobre como configurar serviços no Places, veja Serviços no Places.
O valor tem de ser fornecido como uma matriz de ligações, conforme mostrado no Exemplo 4. Cada ligação deve conter as seguintes propriedades: Nome, Valor e Tipo. Por exemplo, uma ligação seria escrita como @{name="TestLink"; value="https://contoso.com/"; type="Url"}.
Nome
Esta cadeia de carateres é utilizada para mostrar como a ligação ou o nome da aplicação é apresentado na aplicação Places.
O comprimento máximo é de 200 carateres.
Valor
Este valor deve ser uma ligação de URL ou um ID de aplicação do Teams. Os IDs de aplicações do Teams podem ser encontrados na página Detalhes da Aplicação da aplicação na página Gerir aplicações no centro de administração do Teams.
O comprimento máximo é de 1000 carateres.
O tipo tem de ser um dos tipos suportados:
URL – indica que se trata de uma ligação de URL.
MetaOsApp - indica que esta ligação é uma aplicação do Teams.
Observação
Todo o conjunto será substituído na atualização. Para adicionar ou remover um valor, certifique-se de que inclui valores anteriores que devem ser persistentes.
| Atributo | Descrição |
|---|---|
| Tipo: | Ligação[] |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-SortOrder
O parâmetro SortOrder especifica a sequência de ordenação do piso. Por exemplo, um piso pode ter o nome "Lobby" com uma sequência de ordenação de 0 para mostrar este piso primeiro em listas ordenadas.
| Atributo | Descrição |
|---|---|
| Tipo: | System.Int32 |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Estado
O parâmetro State especifica o estado ou província do edifício. O comprimento máximo é de 200 carateres.
Recomendamos a gestão dos dados de localização no Edifício em vez da Sala/Área de Trabalho. Há uma hierarquia entre salas -> pisos -> edifícios, e sala herda os atributos de localização do seu Edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Rua
O parâmetro Rua especifica o endereço físico do edifício. O comprimento máximo é de 200 carateres.
Recomendamos a gestão dos dados de localização no Edifício em vez da Sala/Área de Trabalho. Há uma hierarquia entre salas -> pisos -> edifícios e salas herdam os atributos de localização do respetivo Edifício.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
-Tags
O parâmetro Etiquetas especifica funcionalidades adicionais da sala (por exemplo, detalhes como o tipo de vista ou tipo de mobiliário). Atualmente, não existe um comprimento máximo.
Pode especificar várias etiquetas separadas por vírgulas. Se as etiquetas contiverem espaços, coloque os valores entre aspas: "Label 1","Label 2",..."Label N".
Observação
Todo o conjunto será substituído na atualização. Para adicionar ou remover um valor, certifique-se de que inclui valores anteriores que devem ser persistentes.
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Falso |
| Aceitar entrada de pipeline: | Falso |
| Aceitar carateres universais: | Falso |
Solução de problemas
Estou a receber um erro de permissões negadas.
Set-PlaceV3 requer uma das seguintes funções: TenantPlacesManagement, GlobalAdmin ou MailRecepients. Uma vez que as funções podem ser atribuídas de formas diferentes, seguem-se as formas suportadas de atribuir permissões de função:
- Se a permissão for atribuída através do Exchange Administração Center (que só suporta permissões permanentes), não deverá ter problemas com a utilização dos cmdlets Places. Não seria de esperar que visualizasse um erro de Permissão Negada.
- Se a permissão for atribuída através de Entra diretamente ao utilizador (como uma função permanente ou temporária), não deverá ter problemas com a utilização dos cmdlets Places. Não seria de esperar que visualizasse um erro de Permissão Negada. No entanto, poderá haver algum atraso na sincronização entre Entra e Exchange.
- Se a permissão for atribuída através de Entra a um grupo no Entra, do qual o utilizador faz parte, tal não é suportado pelo Exchange e o grupo role-through não será respeitado. Os cmdlets do Exchange e Places cmdlets falharão com a permissão negada. Este comportamento esperado é descrito aqui.
Atribuí um ParentId a um recurso, mas ainda não o vejo no Places Finder.
A correlação entre o recurso e o respetivo Piso principal pode demorar até 24 horas a aparecer nas experiências Places. Estamos a trabalhar para eliminar este atraso.
Como fazer definir uma fotografia num recurso?
A Set-UserPhoto foi preterida em abril de 2024. Estamos a trabalhar para adicionar um parâmetro a este cmdlet para definir uma fotografia em salas e áreas de trabalho ao utilizar Set-PlaceV3. Entretanto, siga estas instruções para definir a fotografia numa sala ou área de trabalho.
De momento, não é possível colocar fotografias num edifício ou num piso.