New-Place

Use o cmdlet New-Place para criar edifícios, pisos, seções, salas, espaços de trabalho ou mesas no diretório do Places.

Sintaxe

Compilando

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

Andar

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-SortOrder]
 [-Tags]

Seção

Uma seção é um agrupamento lógico de espaços dentro de um andar, como um bairro.

• Mesas e espaços de trabalho devem pertencer a uma seção.
• Os ambientes podem ser atribuídos a uma seção ou diretamente associados a um andar.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

Room

A criação de uma sala provisiona automaticamente uma caixa de correio associada. Se você fornecer um EmailAddress no parâmetro Mailbox, uma nova caixa de correio será criada com esse nome e vinculada à sala.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Espaço de trabalho

A criação de um workspace (pool de mesas) provisiona automaticamente uma caixa de correio associada. Se você fornecer um EmailAddress no parâmetro Mailbox, uma nova caixa de correio será criada com esse nome e vinculada ao workspace.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Escrivaninha

Uma mesa representa uma unidade de mesa individual. Cada mesa tem uma propriedade Mode que define como ela pode ser usada:

• Reservável – Pode ser reservado com antecedência.
• Drop-In – Disponível apenas para uso no local.
• Atribuído – Atribuído a um usuário específico.
• Indisponível – Não disponível para reserva.

O Modo de Mesa e Caixa de Correio funciona da seguinte maneira:

• Comportamento padrão: Se o Modo não estiver definido, o padrão da mesa será Indisponível. Nenhuma caixa de correio é criada.
• Modo Reservado ou DropIn: É necessária uma caixa de correio de mesa. Um é criado automaticamente quando a mesa é provisionada ou você pode vincular a uma existente.
  • Se você fornecer um EmailAddress existente no parâmetro Mailbox, a mesa será vinculada a essa caixa de correio.
  • Se você fornecer um EmailAddress que não existe, uma nova caixa de correio será criada com esse nome e vinculada à mesa.
  • Se nenhum EmailAddress for fornecido, uma caixa de correio será criada automaticamente com um nome gerado pelo sistema e vinculada à mesa.
• Modo Atribuído ou Indisponível: A vinculação de uma caixa de correio é opcional e nenhuma caixa de correio é criada. No entanto, você pode associar manualmente essas mesas a caixas de correio personalizadas, se necessário.
• Alterar o modo depois: Se a mesa iniciar no modo Indisponível e nenhuma caixa de correio estiver vinculada, alternar a mesa para Reservável usando o cmdlet Set-PlaceV3 criará e vinculará automaticamente uma caixa de correio. No entanto, vincular uma caixa de correio a uma mesa não atualiza o modo da mesa automaticamente.

Ao contrário de salas ou espaços de trabalho, as mesas não sincronizam metadados como Capacidade ou DisplayName com propriedades de caixa de correio. A caixa de correio é usada principalmente pelo mecanismo de reservas, enquanto os metadados são lidos do diretório do Places.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]
 [-Mode]

Descrição

O Microsoft Places exige uma hierarquia completa para edifícios, pisos, seções, salas, espaços de trabalho e mesas.

• Um andar deve pertencer a um edifício.
• Uma seção deve pertencer a um andar.
• Uma sala deve pertencer a um andar ou seção.
• Um espaço de trabalho ou mesa deve pertencer a uma seção.

Use a propriedade ParentId para vincular entidades.

Para executar este cmdlet, você precisa de uma destas funções: Administrador de Places, Administrador do Exchange ou funções personalizadas com permissões TenantPlacesManagement.

Exemplos

Exemplo 1

Este exemplo cria um novo edifício e um andar dentro desse edifício.

New-Place -Type Building -Name 'Building 3'

Depois que o Edifício 3 for criado com êxito, leia seu PlaceId a ser usado ao definir o ParentId nos andares.

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

Exemplo 2

Este exemplo cria um novo edifício com informações de endereço.

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

Exemplo 3

Este exemplo cria um novo edifício com links de recursos.

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

Exemplo 4

Este exemplo cria uma nova sala parente de uma seção e com uma capacidade 10, sem especificar detalhes da caixa de correio. Uma caixa de correio de sala é criada e vinculada automaticamente.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Capacity 10

Exemplo 5

Este exemplo cria uma nova sala com pais de uma seção e fornece detalhes da caixa de correio

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Exemplo 6

Este exemplo cria um novo workspace (pool de mesas) parente de uma seção e fornece detalhes de uma caixa de correio

New-Place -Name 'Deskpool A' -Type Workspace -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Exemplo 7

Este exemplo cria uma mesa reservável com um pai de seção sem especificar 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 8

Este exemplo cria uma mesa reservável com pai de uma seção e fornece uma caixa de correio. Se a caixa de correio existir, a mesa será vinculada a ela, caso contrário, uma nova caixa de correio de mesa será criada automaticamente com o nome fornecido.

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

Exemplo 9

Este exemplo cria uma mesa de modo atribuído parente de uma seção e a atribui a uma pessoa. Somente a pessoa designada pode usar esta mesa. Outros não podem mais reservá-lo.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
New-Place -Name 'Bookable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Assigned';Metadata=$modemetadata}

Parâmetros

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

As informações de endereço são usadas pela página Places Explore para mostrar edifícios próximos.

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

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

-DisplayName

O parâmetro DisplayName especifica o nome de exibição do local. O comprimento máximo é de 200 caracteres.

O nome de exibição de um edifício é visível:

• No Outlook, quando os usuários configuram suas horas e local de trabalho, eles podem selecionar um prédio.
• Página In Places Explore que mostra quem mais está no mesmo prédio, prédios próximos e muito mais.
• No Places Finder, como um filtro ao pesquisar uma sala de conferência ou espaço de trabalho.

O nome de exibição de um andar é visível no Localizador de Places como um filtro ao pesquisar uma sala de conferência ou espaço de trabalho.

-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. O comprimento máximo é de 200 caracteres.

-Links de Recursos

O parâmetro ResourceLinks especifica links externos ou IDs de aplicativos do Teams que devem ser associados a este 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 1000 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.

-Marcas

O parâmetro Tags especifica outros recursos 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".

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

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 do modo deve conter as seguintes propriedades: Nome e Metadados, conforme mostrado no Exemplo 5. 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, Drop-In, Assigned e Unavailable. Para pools de mesa, os modos com suporte são Reservable, Drop-In 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 Reservável e Drop-In 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.

-Tipo

O parâmetro Tipo especifica o tipo do local que está sendo criado. Os valores válidos são:

• Compilando
• Andar
• Seção
• Room
• Espaço de trabalho
• Escrivaninha