Set-Place
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Set-Place para atualizar caixas de correio de sala com metadados adicionais, o que fornece uma melhor experiência de pesquisa e sugestão de sala.
Observação: em ambientes híbridos, esse cmdlet não funciona nas seguintes propriedades em caixas de correio de sala sincronizadas: City, CountryOrRegion, GeoCoordinates, Phone, PostalCode, State ou Street. Para modificar essas propriedades (exceto GeoCoordinates em caixas de correio de sala sincronizadas), use os cmdlets Set-User ou Set-Mailbox no Exchange local.
Nota: Recomendamos usar este cmdlet com o módulo EXO V3. Os comandos que usam 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, consulte Sobre o módulo do PowerShell do Exchange Online.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
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>]
[-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, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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ência 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 chamada Sala de Conferência 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 essa sala não tem dispositivo de áudio, use o valor $null para esse 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 o ambiente está. 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 City 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 a região da sala. 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.
O nome amigável é retornado no valor da propriedade CountryOrRegion pelo cmdlet Get-Place, mas você pode usar o nome amigável ou o código do 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 exibição 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 dispositivo de exibição, use o valor $null para esse 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 de piso em que a sala está.
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 um rótulo descritivo para o andar em que a sala está. 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 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"
Observação: se os separadores de ponto final não funcionarem, use 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 Identity especifica a caixa de correio da sala que você deseja modificar. Você pode usar 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: O quarto é acessível para cadeiras de rodas.
- $false: O quarto não é acessível para cadeiras de rodas. Esse valor é o padrã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 um rótulo descritivo 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
Observação: atualmente, esse parâmetro é apenas informativo e não resulta em nenhuma funcionalidade adicional.
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 salas 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 ingressam em reuniões do Teams usando o áudio do computador ou do dispositivo móvel em vez de usar o áudio da sala. Esse valor é o padrã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
Observação: esse recurso é experimental e está disponível apenas para organizações que usam o Microsoft Places.
O parâmetro ParentId especifica a ID de um lugar na hierarquia de localização pai no Microsoft Places.
As organizações que estão integrando salas e espaços de trabalho para Microsoft Places precisam usar os parâmetros ParentId e ParentType em um comando Set-Place para 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 |
-Phone
Aplicável: Exchange Online
O parâmetro Phone 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 CEP especifica o CEP 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 Tags especifica recursos adicionais da sala (por exemplo, detalhes como o tipo de vista ou o tipo de mobiliário).
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".
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 essa sala não tem dispositivo de vídeo, use o valor $null para esse 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 mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.