Set-PlaceV3

Utilize o cmdlet Set-PlaceV3 para atualizar metadados sobre as suas secretárias, salas, áreas de trabalho, secções, pisos ou edifícios no seu diretório Places.

Sintaxe

Compilando

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

Andar

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

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]

Secretária

As secretárias são um tipo de entidade recentemente introduzido no Microsoft Places, que representa unidades de secretária individuais. Cada secretária inclui uma propriedade Modo que especifica a forma como a secretária pode ser reservada. Para obter mais informações, consulte a secção de modo abaixo.

Para Desk, existem algumas dependências entre o modo e a caixa de correio da seguinte forma:

• Se a propriedade Modo não estiver definida, a predefinição de secretária é Indisponível e nenhuma caixa de correio de secretária é criada automaticamente.
• Para as secretárias definidas para o modo Reservable ou DropIn, é necessária uma caixa de correio de secretária. Uma é criada automaticamente quando a secretária é aprovisionada. Em alternativa, pode ligar uma caixa de correio existente ao especificar o EmailAddress no parâmetro Caixa de Correio.
• Para as secretárias no modo Atribuído ou Indisponível, ligar uma caixa de correio é opcional e não é criada nenhuma caixa de correio por predefinição. No entanto, pode associar manualmente estas secretárias a caixas de correio personalizadas, se necessário.
• Se nenhum modo estiver configurado inicialmente, a secretária permanecerá no modo Indisponível. Ligar uma caixa de correio posteriormente não atualiza automaticamente o modo de secretária.

Ao contrário dos tipos de Sala ou Área de Trabalho, as secretárias não são aprovisionadas automaticamente simplesmente ao criar uma caixa de correio. Além disso, os metadados como Capacity ou DisplayName não são sincronizados com as propriedades da caixa de correio. A caixa de correio é utilizada principalmente pelo motor de reserva, enquanto os metadados são lidos a partir do Diretório Places.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

Room

Set-PlaceV3 suporta parâmetros de localização legados que já estão disponíveis no cmdlet exchange Set-Place. No entanto, assim que uma sala estiver ligada a um piso ou edifício com o parâmetro , os -ParentId detalhes da localização (Street e City) devem ser geridos ao nível do edifício, não na sala ou área de trabalho individual.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

Espaço de trabalho

Set-PlaceV3 suporta parâmetros de localização legados que já estão disponíveis no cmdlet exchange Set-Place. No entanto, assim que uma área de trabalho estiver ligada a uma secção com o parâmetro , os -ParentId detalhes da localização (Street e City) devem ser geridos ao nível do edifício e não na sala ou área de trabalho individual.

A área de trabalho suporta a propriedade Modo. Os detalhes para os mesmos estão documentados na Mode secção de parâmetros.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

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.

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 as coordenadas geográficas 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 secretária reserval numa secção sem especificar os detalhes da caixa de correio. É criada e ligada automaticamente uma caixa de correio de secretária e a propriedade MailboxOID é preenchida. A secretária aparece no Places Finder e está disponível para reserva por qualquer pessoa.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'}

Exemplo 6

Este exemplo atualiza o valor do modo para o modo DropIn.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -Mode @{Name='DropIn'}

Exemplo 7

Este exemplo atualiza o valor do modo para Modo atribuído.

Tenha em atenção que, mesmo que a secretária já seja uma secretária de modo atribuído, a alteração é apenas o campo de metadados. É necessário criar um novo objeto de modo e substituir o antigo.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a Mode @{Name='Assigned';Metadata=$modemetadata}

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 [preterido]
• Alias [preterido]
• Nome único (DN) [preterido]
• DN Canónico [preterido]
• GUID [preterido]
• Endereço de email

Por exemplo, para locais que não se baseiam numa caixa de correio (edifícios, pisos, secções e mesas):

• Nome
• GUID

-AudioDeviceName e -VideoDeviceName

Estes parâmetros especificam o nome dos dispositivos de áudio 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 ou vídeo, utilize o valor $null para o parâmetro .

-Edifício

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 (").

-Capacidade

O parâmetro Capacidade especifica a capacidade da sala ou área de trabalho. O valor válido é um número inteiro.

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

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

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

-DisplayDeviceName

O parâmetro DisplayDeviceName especifica o nome do dispositivo a apresentar no local (sala, secretária ou área de trabalho). Se o valor contiver espaços, coloque-o entre aspas (").

O valor padrão é em branco ($null). Para indicar que este local não tem nenhum dispositivo de apresentação, utilize o valor $null para este parâmetro.

-FloorLabel

O parâmetro FloorLabel especifica uma etiqueta descritiva para o piso. Se o valor contiver espaços, coloque-o entre aspas (").

-Piso

O parâmetro Floor especifica a sequência de ordenação do piso dentro de um edifício específico.

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

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

-MTREnabled

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.

-DisplayName

O parâmetro DisplayName especifica o nome a apresentar do local. O comprimento máximo é de 200 carateres. Para atualizar o nome a apresentar de uma sala ou área de trabalho que tenha um endereço SMTP associado, precisa da função Administrador de Locais, Administrador do Exchange ou Administração Global.

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

-Código Postal

O parâmetro Código Postal especifica o código postal do edifício.

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

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

-Estado

O parâmetro State especifica o estado ou província do edifício. O comprimento máximo é de 200 carateres.

-Rua

O parâmetro Rua especifica o endereço físico do edifício. O comprimento máximo é de 200 carateres.

-Modo

O parâmetro Modo define como um local se destina a ser utilizado ou reservado. Atualmente, o modo só está disponível para secretárias e conjuntos de secretária (áreas de trabalho).

Atualmente, existem quatro modos no total.

• Reservable - As mesas reservadas são as mesas que estão configuradas para serem reservadas com antecedência ou no local.
• Drop-in – a secretária está disponível para utilização no local e não pode ser reservada com antecedência. Pode utilizar a capacidade do Microsoft Teams para ligar os dispositivos periféricos presentes nestas secretárias ao objeto de secretária individual no diretório.
• Atribuído – uma secretária atribuída está permanentemente ligada a um utilizador específico e não pode ser reservada por outras pessoas. Todas as secretárias atribuídas têm de ter sempre um utilizador designado.
• Indisponível – a secretária não está disponível para reserva devido a manutenção ou por qualquer outro motivo.

O valor do modo deve conter as seguintes propriedades: Nome e Metadados, conforme mostrado no Exemplo 6. O nome é cadeia e os metadados são um objeto de dicionário.

• Nome: o campo Nome especifica o modo ativo para um local. Utiliza um valor de enumeração e as opções disponíveis variam consoante o tipo de local. Para as secretárias, os modos suportados incluem Reservable, DropInAssigned e Unavailable. Para conjuntos de secretária, os modos suportados são Reservable, DropIn e Unavailable.

• Metadados: o campo Metadados é um dicionário utilizado para armazenar informações adicionais relevantes para o modo selecionado. Estes metadados suportam a lógica de negócio associada a cenários de reservas específicos.

  • Places nos modos Reservable e DropIn não suportam campos de metadados.
  • Places no modo Indisponível suportam um Reason campo (cadeia) que explica o motivo pelo qual a secretária está indisponível. Os valores incluem New para secretárias recém-criadas e Maintenance para Places em serviço.
  • O modo atribuído suporta dois campos de metadados: AssignedPersonEmailAddress e AssignedPersonId. Estes identificam o utilizador atribuído à secretária. Fornecer um dos campos é suficiente para ativar o modo atribuído.

-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".

Solução de problemas

Estou a receber um erro de permissão negada.

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 visse 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 visse 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, isto 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.