Set-PlaceV3

Use o cmdlet Set-PlaceV3 para atualizar metadados sobre suas mesas, salas, espaços de trabalho, seções, andares ou edifícios no 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 seção é um agrupamento de espaços dentro de um andar, por exemplo, um bairro. Mesas e espaços de trabalho devem ser parentes de uma seção. Opcionalmente, as salas também podem ser parentadas de uma seção ou podem ser parentadas diretamente de um andar.

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

Escrivaninha

As mesas são um tipo de entidade recém-introduzido no Microsoft Places, representando unidades de mesa individuais. Cada mesa inclui uma propriedade Mode que especifica como a mesa pode ser reservada. Para obter mais informações, consulte a seção de modo abaixo.

Para o Desk, há algumas dependências entre o modo e a caixa de correio, da seguinte maneira:

• Se a propriedade Mode não estiver definida, o padrão da mesa será Indisponível e nenhuma caixa de correio de mesa será criada automaticamente.
• Para mesas definidas como modo Reservado ou DropIn, é necessária uma caixa de correio de mesa. Um é criado automaticamente quando a mesa é provisionada. Como alternativa, você pode vincular uma caixa de correio existente especificando o EmailAddress no parâmetro Mailbox.
• Para mesas no modo Atribuído ou Indisponível, vincular uma caixa de correio é opcional e nenhuma caixa de correio é criada por padrão. No entanto, você pode associar manualmente essas mesas a caixas de correio personalizadas, se necessário.
• Se nenhum modo for configurado inicialmente, a mesa permanecerá no modo Indisponível. Vincular uma caixa de correio posteriormente não atualiza automaticamente o modo da mesa.

Ao contrário dos tipos de Sala ou Workspace, as mesas não são provisionadas automaticamente criando uma caixa de correio. Além disso, metadados como Capacity ou DisplayName não são sincronizados com as propriedades da caixa de correio. A caixa de correio é usada principalmente pelo mecanismo de reservas, enquanto os metadados são lidos do diretório do Places.

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

Room

Set-PlaceV3 dá suporte a parâmetros de localização herdados que já estão disponíveis no cmdlet do Exchange Set-Place. No entanto, uma vez que uma sala é vinculada a um andar ou edifício usando o -ParentId parâmetro, os detalhes de localização (Street e City) devem ser gerenciados no nível do edifício, não na sala ou espaço de trabalho individual.

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

Espaço de trabalho

Set-PlaceV3 dá suporte a parâmetros de localização herdados que já estão disponíveis no cmdlet do Exchange Set-Place. No entanto, uma vez que um espaço de trabalho é vinculado a uma seção usando o parâmetro, os -ParentId detalhes de localização (Street e City) devem ser gerenciados no nível do edifício, não na sala ou espaço de trabalho individual.

O workspace dá suporte à propriedade Mode. Os detalhes para o mesmo estão documentados na Mode seção de parâmetros.

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

Descrição

O Places depende de uma hierarquia totalmente configurada entre suas salas/espaços de trabalho, andares e edifícios. Depois que os edifícios e andares são criados, você pode vinculá-los usando parentId. Uma sala deve ter um andar ou seção pai. Um espaço de trabalho ou mesa deve ter uma seção pai. Uma seção deve ter um piso pai. Um andar deve ter um edifício pai.

Para executar esse cmdlet, você precisa ter permissões. Você deve ter a função de Administração do Exchange ou a função de TenantPlacesManagement do Places.

Exemplos

Exemplo 1

Este exemplo configura a hierarquia de diretórios para uma sala, um andar e um edifício.

Neste exemplo, o PlaceId do andar é f12172b6-195d-4e6e-8f4f-eb72e41de99a, e o PlaceId do edifício é daa2f89b-75c4-4eb7-adcc-ff249233338d.

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 os links de recursos para um edifício com links de recursos. O conjunto inteiro é substituído na atualização. Para adicionar ou remover um valor, inclua os valores anteriores que devem ser mantidos.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

Exemplo 5

Este exemplo cria uma mesa reservável em uma seção sem especificar os detalhes da caixa de correio. Uma caixa de correio de mesa é criada e vinculada automaticamente, e a propriedade MailboxOID é preenchida. O balcão aparece no Localizador de Places 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 de 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.

Observe que, mesmo que a mesa já seja uma mesa de modo atribuído, a alteração é apenas o campo de metadados. Um objeto de modo totalmente novo precisa ser criado 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 identity especifica o local que você deseja atualizar. Você pode usar qualquer valor que identifique exclusivamente um lugar.

Por exemplo, para locais com base em uma caixa de correio (salas de conferência e espaços de trabalho):

• Nome [preterido]
• Alias [preterido]
• DN (nome distinto) [preterido]
• DN canônico [preterido]
• GUID [preterido]
• Endereço de email

Por exemplo, para locais que não são baseados em uma caixa de correio (edifícios, pisos, seções e mesas):

• Nome
• GUID

-AudioDeviceName e -VideoDeviceName

Esses 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 essa sala não tem nenhum dispositivo de áudio ou vídeo, use o valor $null para o parâmetro.

-Construção

O parâmetro Edifício especifica o nome do edifício ou o número do edifício em que o ambiente está. Se o valor contiver espaços, coloque-o entre aspas (").

-Capacidade

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

-Cidade

O parâmetro City especifica a cidade do edifício. Se o valor contiver espaços, coloque-o entre aspas ("). O comprimento máximo é de 200 caracteres.

-CountryOrRegion

O parâmetro CountryOrRegion especifica o país ou a região do edifício. Um valor válido é um código de país de duas letras ISO 3166-1 válido (por exemplo, AU para Austrália) ou o nome amigável correspondente para o país (que pode ser diferente do nome abreviado oficial da Agência de Manutenção ISO 3166).

Uma referência para códigos de país de duas letras está disponível em Lista de códigos de país.

-Rótulo

O parâmetro Rótulo especifica um rótulo descritivo para o local. Se o valor contiver espaços, coloque-o entre aspas ("). O comprimento máximo é de 200 caracteres.

Para salas e espaços de trabalho, o comando atualiza o valor denominado -Label no Set-Place do Exchange.

-DisplayDeviceName

O parâmetro DisplayDeviceName especifica o nome do dispositivo de exibição no local (sala, mesa ou espaço de trabalho). Se o valor contiver espaços, coloque-o entre aspas (").

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

-FloorLabel

O parâmetro FloorLabel especifica um rótulo descritivo para o piso. Se o valor contiver espaços, coloque-o entre aspas (").

-Chão

O parâmetro Floor especifica a ordem de classificação do andar em um determinado edifício.

-GeoCoordenadas

O parâmetro GeoCoordinates especifica a localização do edifício em coordenadas de latitude, longitude e (opcionalmente) altitude. Um valor válido para esse parâmetro usa 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 ponto final não funcionarem, use 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 para cadeiras de rodas.
• $false: O lugar não é acessível para cadeiras de rodas. Esse é o valor padrão.

-MTREnabled

O parâmetro MTREnabled identifica a sala conforme configurada com um sistema de sala do Microsoft Teams. Você pode adicionar sistemas de sala do Teams como fontes de áudio em reuniões do Teams que envolvem a sala. Os valores válidos são:

• $true: a sala tem um sistema de sala do Teams. Você pode adicionar o sistema de sala do Teams às reuniões do Microsoft Teams ao selecionar ingressar em uma reunião com áudio de sala.
• $false: a sala não tem um sistema de sala do Teams. Os usuários podem ingressar em reuniões do Teams usando o áudio do computador ou do dispositivo móvel em vez de usar 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 de exibição do local. O comprimento máximo é de 200 caracteres. Para atualizar o nome de exibição de uma sala ou espaço de trabalho que tenha um endereço SMTP associado, você precisa da função Administrador do Local, Administrador do Exchange ou Administração Global.

-ParentId

O parâmetro ParentId especifica a ID de um lugar na hierarquia de localização pai no Microsoft Places. Uma sala deve ter um andar ou seção pai. Um espaço de trabalho ou mesa deve ter uma seção pai. Uma seção deve ter um piso pai. Um andar deve ter um edifício pai.

-CEP

O parâmetro CEP especifica o CEP do edifício.

-Links de Recursos

O parâmetro ResourceLinks especifica links externos ou IDs de aplicativos do Teams que devem ser associados a esse edifício, como um menu de jantar, um link para serviços ou um aplicativo do Teams para gerenciamento de visitantes. Para obter mais informações sobre como configurar serviços no Places, consulte Serviços no Places.

O valor deve ser fornecido como uma matriz de links, conforme mostrado no Exemplo 4. Cada link deve conter as seguintes propriedades: Nome, Valor e Tipo. Por exemplo, um link seria escrito como @{name="TestLink"; value="https://contoso.com/"; type="Url"}.

• Nome

  • Essa cadeia de caracteres é usada para mostrar como o link ou o nome do aplicativo é exibido no aplicativo Places.

  • O comprimento máximo é de 200 caracteres.

• Valor

  • Esse valor deve ser um link de URL ou uma ID do aplicativo Teams. As IDs de aplicativo do Teams podem ser encontradas na página Detalhes do aplicativo na página Gerenciar aplicativos no Centro de administração do Teams.

  • O comprimento máximo é de 1.000 caracteres.

• O tipo deve ser um dos tipos com suporte:

  • Url - indica que este é um link de URL.

  • MetaOsApp – indica que este link é um aplicativo do Teams.

-SortOrder

O parâmetro SortOrder especifica a ordem de classificação do andar. Por exemplo, um andar pode ser chamado de "Lobby" com uma ordem de classificação de 0 para mostrar esse andar primeiro nas listas ordenadas.

-Estado

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

-Rua

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

-Mode

O parâmetro Mode define como um lugar deve ser usado ou reservado. Atualmente, o modo está disponível apenas para mesas e pools de mesas (espaços de trabalho).

Atualmente, existem quatro modos no total.

• Reservável - As mesas reserváveis são as mesas configuradas para serem reservadas com antecedência ou no local.
• Drop-in- A mesa está disponível para uso no local e não pode ser reservada com antecedência. Você pode usar o recurso do Microsoft Teams para vincular os dispositivos periféricos presentes nessas mesas ao objeto de mesa individual no diretório.
• Atribuído - Uma mesa atribuída está permanentemente vinculada a um usuário específico e não pode ser reservada por outras pessoas. Cada mesa atribuída deve sempre ter um usuário designado.
• Indisponível- O balcão não está disponível para reserva devido a manutenção ou por qualquer outro motivo.

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

• Nome: O campo Nome especifica o modo ativo de um local. Ele usa um valor de enumeração e as opções disponíveis variam de acordo com o tipo de lugar. Para mesas, os modos com suporte incluem Reservable, DropIn, Assigned e Unavailable. Para pools de mesa, os modos com suporte são Reservable, DropIn e Unavailable.

• Metadados: O campo Metadados é um dicionário usado para armazenar informações adicionais relevantes para o modo selecionado. Esses metadados dão suporte à lógica de negócios vinculada a cenários de reserva específicos.

  • Places nos modos Reservado e DropIn não dão suporte a nenhum campo de metadados.
  • Places no modo Indisponível suporta um Reason campo (cadeia de caracteres) que explica por que a mesa está indisponível. Os valores incluem New para mesas recém-criadas e Maintenance para Places em serviço.
  • O modo atribuído dá suporte a dois campos de metadados: AssignedPersonEmailAddress e AssignedPersonId. Identificam o usuário atribuído à mesa. Fornecer qualquer um dos campos é suficiente para habilitar o modo atribuído.

-Marcas

O parâmetro Tags especifica recursos adicionais da sala (por exemplo, detalhes como o tipo de vista ou o tipo de mobiliário). No momento, não há comprimento máximo.

Você pode especificar vários rótulos separados por vírgulas. Se os rótulos contiverem espaços, coloque os valores entre aspas: "Label 1","Label 2",..."Label N".

Solução de problemas

Estou recebendo um erro de permissão negada.

Set-PlaceV3 requer uma das seguintes funções: TenantPlacesManagement, GlobalAdmin ou MailRecepients. Como as funções podem ser atribuídas de diferentes maneiras, estas são as maneiras com suporte para atribuir permissões de função:

• Se a permissão for atribuída por meio do Centro de Administração do Exchange (que só dá suporte a permissões permanentes), você não deverá ter problemas com o uso dos cmdlets do Places. Não seria esperado que você visse um erro de permissão negada.
• Se a permissão for atribuída por meio do Entra diretamente ao usuário (como uma função permanente ou temporária), você não deverá ter problemas com o uso dos cmdlets do Places. Não seria esperado que você visse um erro de permissão negada. No entanto, pode haver algum atraso na sincronização entre o Entra e o Exchange.
• Se a permissão for atribuída por meio do Entra a um grupo no Entra, do qual o usuário faz parte, isso não será suportado pelo Exchange e a função por meio do grupo não será respeitada. Os cmdlets do Exchange e do Places falharão com a permissão negada. Esse comportamento esperado é descrito aqui.

Atribuí um ParentId a um recurso, mas ainda não o vejo no Localizador de Places.

Pode levar até 24 horas para que a correlação entre o recurso e seu andar pai apareça nas experiências do Places. Estamos trabalhando para eliminar esse atraso.

Como fazer definir uma foto em um recurso?

O Set-UserPhoto foi preterido em abril de 2024. Estamos trabalhando para adicionar um parâmetro a esse cmdlet para definir uma foto em salas e espaços de trabalho ao usar Set-PlaceV3. Enquanto isso, siga estas instruções para definir a foto em uma sala ou espaço de trabalho.

No momento, não é possível definir fotos em um prédio ou andar.