New-Place

Utilize o cmdlet New-Place para criar edifícios, pisos, secções, salas, áreas de trabalho ou secretárias no seu diretório 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 secção é um agrupamento lógico de espaços num piso, como um bairro.

• As secretárias e as áreas de trabalho têm de pertencer a uma secção.
• As salas podem ser atribuídas a uma secção ou diretamente associadas a um piso.

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

Room

Criar uma sala aprovisiona automaticamente uma caixa de correio associada. Se fornecer um EmailAddress no parâmetro Caixa de Correio, será criada uma nova caixa de correio com esse nome e ligada à sala.

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

Espaço de trabalho

A criação de uma área de trabalho (conjunto de secretária) aprovisiona automaticamente uma caixa de correio associada. Se fornecer um EmailAddress no parâmetro Caixa de Correio, será criada uma nova caixa de correio com esse nome e ligada à área de trabalho.

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

Secretária

Uma secretária representa uma unidade de secretária individual. Cada secretária tem uma propriedade Mode que define como pode ser utilizada:

• Reservable – pode ser reservado com antecedência.
• Drop-In – disponível apenas para utilização no local.
• Atribuído – atribuído a um utilizador específico.
• Indisponível – não disponível para reserva.

O Modo de Secretária e a Caixa de Correio funcionam da seguinte forma:

• Comportamento predefinido: Se o Modo não estiver definido, a predefinição de secretária é Indisponível. Não é criada nenhuma caixa de correio.
• Modo Reservable ou DropIn: É necessária uma caixa de correio de secretária. Uma é criada automaticamente quando a secretária é aprovisionada ou pode ligar a uma existente.
  • Se fornecer um EmailAddress existente no parâmetro Caixa de Correio, a secretária liga a essa caixa de correio.
  • Se fornecer um EmailAddress que não existe, é criada uma nova caixa de correio com esse nome e ligada à secretária.
  • Se não for fornecido um EmailAddress, é criada automaticamente uma caixa de correio com um nome gerado pelo sistema e ligada à secretária.
• Modo Atribuído ou Indisponível: Ligar uma caixa de correio é opcional e não é criada nenhuma caixa de correio. No entanto, pode associar manualmente estas secretárias a caixas de correio personalizadas, se necessário.
• Alterar o modo mais tarde: Se a secretária iniciar no modo Indisponível e nenhuma caixa de correio estiver ligada, mudar a secretária para Reservable através do cmdlet Set-PlacesV3 irá criar e ligar automaticamente uma caixa de correio. No entanto, ligar uma caixa de correio a uma secretária não atualiza automaticamente o modo de secretária.

Ao contrário das salas ou áreas de trabalho, as secretárias não sincronizam metadados como Capacidade ou DisplayName 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.

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

Descrição

Microsoft Places requer uma hierarquia completa para edifícios, pisos, secções, salas, áreas de trabalho e secretárias.

• Um piso deve pertencer a um edifício.
• Uma secção tem de pertencer a um piso.
• Uma sala tem de pertencer a um piso ou secção.
• Uma área de trabalho ou secretária tem de pertencer a uma secção.

Utilize a propriedade ParentId para ligar entidades.

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

Exemplos

Exemplo 1

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

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

Depois de o Edifício 3 ser criado com êxito, leia o PlaceId para utilizar ao definir o ParentId nos pisos.

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 ligações 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 principal para uma secção e com uma capacidade 10, sem especificar os detalhes da caixa de correio. Uma caixa de correio de sala é criada e ligada automaticamente.

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

Exemplo 5

Este exemplo cria uma nova sala principal para uma secção e fornece detalhes de uma caixa de correio

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

Exemplo 6

Este exemplo cria uma nova área de trabalho (conjunto de secretária) principalizada para uma secçã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 secção com suporte de reserva principal 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 8

Este exemplo cria uma secretária reservavel com uma secção e fornece uma caixa de correio. Se a caixa de correio existir, a secretária irá ligar-se à mesma, caso contrário, é criada automaticamente uma nova caixa de correio de secretária 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 um suporte de modo atribuído para uma secção e atribui-o a uma pessoa. Apenas a pessoa atribuída pode utilizar esta secretária. Outros já não podem reservar.

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

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

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

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

-DisplayName

O parâmetro DisplayName especifica o nome a apresentar do local. O comprimento máximo é de 200 carateres.

O nome a apresentar de um edifício está visível:

• No Outlook, quando os utilizadores estão a configurar o horário de trabalho e a localização, podem selecionar um edifício.
• No Places página Explorar que mostra quem mais se encontra no mesmo edifício, edifícios próximos e muito mais.
• No Places Finder, como um filtro ao procurar uma sala de conferências ou área de trabalho.

O nome a apresentar de um piso é visível no Places Finder como um filtro ao procurar uma sala de conferências ou área de trabalho.

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

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

-Tags

O parâmetro Etiquetas especifica outras funcionalidades da sala (por exemplo, detalhes como o tipo de vista ou tipo de mobília). 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".

-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 5. 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, Drop-InAssigned e Unavailable. Para conjuntos de secretária, os modos suportados são Reservable, Drop-In 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 Drop-In 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.

-Tipo

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

• Compilando
• Andar
• Seção
• Room
• Espaço de trabalho
• Secretária