Partilhar via


Set-Place

Esse cmdlet só está disponível no serviço baseado em nuvem.

Utilize o cmdlet Set-Place para atualizar as caixas de correio da sala com metadados adicionais, o que proporciona uma melhor experiência de pesquisa e sugestão de sala.

Nota: em ambientes híbridos, este cmdlet não funciona nas seguintes propriedades em caixas de correio de sala sincronizadas: Cidade, PaísRegião, GeoCoordinates, Telefone, Código Postal, Estado ou Rua. Para modificar estas propriedades (exceto GeoCoordinates em caixas de correio de sala sincronizadas), utilize os cmdlets Set-User ou Set-Mailbox no Exchange no local.

Nota: recomendamos a utilização deste cmdlet com o módulo EXO V3. Os comandos que utilizam Set-Place para alterar determinadas combinações de propriedades em conjunto podem falhar em versões mais antigas do módulo. Para obter mais informações sobre o módulo EXO V3, veja Acerca do módulo Exchange Online PowerShell.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Padrão)

Set-Place
    [-Identity] <RecipientIdParameter>
    [-AudioDeviceName <String>]
    [-Building <String>]
    [-Capacity <System.Int32>]
    [-City <String>]
    [-Confirm]
    [-CountryOrRegion <CountryInfo>]
    [-DisplayDeviceName <String>]
    [-Floor <System.Int32>]
    [-FloorLabel <String>]
    [-GeoCoordinates <GeoCoordinates>]
    [-IsWheelChairAccessible <Boolean>]
    [-Label <String>]
    [-MTREnabled <Boolean>]
    [-ParentId <String>]
    [-ParentType <Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType>]
    [-Phone <String>]
    [-PostalCode <String>]
    [-State <String>]
    [-Street <String>]
    [-Tags <String[]>]
    [-VideoDeviceName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-Place -Identity "Conference Room 01" -IsWheelChairAccessible $true -AudioDeviceName PolyCom -DisplayDeviceName "InFocus WXGA Projector"

O exemplo adiciona os metadados especificados à caixa de correio da sala denominada Sala de Conferências 01.

Exemplo 2

Set-Place -Identity "Conference Room 02" -Building "Building 02" -Capacity 5 -CountryOrRegion ES -Floor 3 -FloorLabel "Human Resources" -Label Interviews

O exemplo adiciona os metadados especificados à caixa de correio da sala denominada Sala de Conferências 02.

Parâmetros

-AudioDeviceName

Aplicável: Exchange Online

O parâmetro AudioDeviceName especifica o nome do dispositivo de áudio 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, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Building

Aplicável: Exchange Online

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Capacity

Aplicável: Exchange Online

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

Propriedades do parâmetro

Tipo:System.Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-City

Aplicável: Exchange Online

O parâmetro Cidade especifica a cidade da sala. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Online

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CountryOrRegion

Aplicável: Exchange Online

O parâmetro CountryOrRegion especifica o país ou região da sala. 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.

O nome amigável é devolvido no valor da propriedade CountryOrRegion pelo cmdlet Get-Place, mas pode utilizar o nome amigável ou o código de país de duas letras nas operações de filtro.

Propriedades do parâmetro

Tipo:CountryInfo
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayDeviceName

Aplicável: Exchange Online

O parâmetro DisplayDeviceName especifica o nome do dispositivo de apresentação 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 apresentação, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Floor

Aplicável: Exchange Online

O parâmetro Floor especifica o número do piso em que a sala se encontra.

Propriedades do parâmetro

Tipo:System.Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FloorLabel

Aplicável: Exchange Online

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GeoCoordinates

Aplicável: Exchange Online

O parâmetro GeoCoordinates especifica a localização da sala 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"

Nota: se os separadores de período não funcionarem para si, utilize vírgulas.

Propriedades do parâmetro

Tipo:GeoCoordinates
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Online

O parâmetro Identidade especifica a caixa de correio da sala que pretende modificar. Pode utilizar qualquer valor que identifique exclusivamente a sala. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Propriedades do parâmetro

Tipo:RecipientIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IsWheelChairAccessible

Aplicável: Exchange Online

O parâmetro IsWheelChairAccessible especifica se a sala é acessível para cadeiras de rodas. Os valores válidos são:

  • $true: A sala é acessível a cadeiras de rodas.
  • $false: A sala não é acessível a cadeiras de rodas. Este valor é a predefinição.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Label

Aplicável: Exchange Online

O parâmetro Label especifica uma etiqueta descritiva para a sala (por exemplo, um número ou nome). Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MTREnabled

Aplicável: Exchange Online

Nota: atualmente, este parâmetro é apenas informativo e não resulta em nenhuma funcionalidade adicional.

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 participam em reuniões do Teams através do áudio do pc ou do dispositivo móvel em vez de utilizarem o áudio da sala. Este valor é a predefinição.

Para obter mais informações sobre Salas do Microsoft Teams, consulte Salas do Microsoft Teams.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ParentId

Aplicável: Exchange Online

Nota: esta funcionalidade é experimental e está disponível apenas para organizações que utilizam Microsoft Places.

O parâmetro ParentId especifica o ID de um Local na hierarquia de localização principal no Microsoft Places.

As organizações que estão a integrar Salas e Áreas de Trabalho para Microsoft Places têm de utilizar os parâmetros ParentId e ParentType num comando Set-Place para que Microsoft Places funcione corretamente.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ParentType

Aplicável: Exchange Online

Nota: esta funcionalidade é experimental e está disponível apenas para organizações que utilizam Microsoft Places.

O parâmetro ParentType especifica o tipo principal do ParentId no Microsoft Places. Os valores válidos são:

  • Andar
  • Seção

As organizações que estão a integrar Salas e Áreas de Trabalho para Microsoft Places têm de utilizar os parâmetros ParentId e ParentType num comando Set-Place para que Microsoft Places funcione corretamente.

Propriedades do parâmetro

Tipo:Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Phone

Aplicável: Exchange Online

O parâmetro Telefone especifica o número de telefone da sala.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PostalCode

Aplicável: Exchange Online

O parâmetro Código Postal especifica o código postal da sala.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-State

Aplicável: Exchange Online

O parâmetro State especifica o estado ou a província da sala.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Street

Aplicável: Exchange Online

O parâmetro Rua especifica o endereço físico da sala.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Tags

Aplicável: Exchange Online

O parâmetro Etiquetas especifica funcionalidades adicionais da sala (por exemplo, detalhes como o tipo de vista ou tipo de mobiliário).

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VideoDeviceName

Aplicável: Exchange Online

O parâmetro VideoDeviceName especifica o nome do dispositivo de 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 vídeo, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Online

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.