New-Place
Utilize o cmdlet New-Place para criar edifícios, pisos, secções ou secretárias no seu diretório Places.
Observação
Para criar salas ou áreas de trabalho, tem de continuar a utilizar o cmdlet New-Mailbox documentado aqui.
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 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.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
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 são lidos a partir do Places Directory.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-GeoCoordinates]
[-Mailbox]
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 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 secção principal num piso e, em seguida, cria uma caixa de correio de secretária e atribui-a a uma entidade de secretária existente. Tenha em atenção que tem ExchangeOnlineManagement o módulo instalado e execute o Connect-ExchangeOnline cmdlet antes de executar este script de exemplo.
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias
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.
| 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.
As informações de endereço são utilizadas pela página Explorar do Places para mostrar edifícios próximos.
| 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.
| 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 |
-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"
Observação
Se os separadores de período não funcionarem para si, utilize vírgulas.
| Atributo | Descrição |
|---|---|
| Tipo: | GeoCoordinates |
| 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.
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.
| 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 utiliza a nova hierarquia enquanto o Outlook Roomfinder continua a utilizar os objetos "Floor" e "FloorLabel" legados. Também tem 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. O comprimento máximo é de 200 carateres.
| 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 é substituído. Para adicionar ou remover um valor, certifique-se de que inclui valores anteriores que devem ser persistentes.
| Atributo | Descrição |
|---|---|
| Tipo: | ResourceLink[] |
| 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.
| 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.
| 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 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".
Observação
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.
| 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 |
-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
- Secretária
| Atributo | Descrição |
|---|---|
| Tipo: | Cadeia de caracteres |
| Posição: | Com nome |
| Valor predefinido: | Nenhum |
| Obrigatório: | Verdadeiro |
| Aceitar entrada de pipeline: | Verdadeiro |
| Aceitar carateres universais: | Falso |