Set-MailboxAutoReplyConfiguration

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Set-MailboxAutoReplyConfiguration para definir configurações de Respostas Automáticas para uma caixa de correio específica.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Set-MailboxAutoReplyConfiguration
   [-Identity] <MailboxIdParameter>
   [-AutoDeclineFutureRequestsWhenOOF <Boolean>]
   [-AutoReplyState <OofState>]
   [-Confirm]
   [-CreateOOFEvent <Boolean>]
   [-DeclineAllEventsForScheduledOOF <Boolean>]
   [-DeclineEventsForScheduledOOF <Boolean>]
   [-DeclineMeetingMessage <String>]
   [-DomainController <Fqdn>]
   [-EndTime <DateTime>]
   [-EventsToDeleteIDs <String[]>]
   [-ExternalAudience <ExternalAudience>]
   [-ExternalMessage <String>]
   [-IgnoreDefaultScope]
   [-InternalMessage <String>]
   [-OOFEventSubject <String>]
   [-StartTime <DateTime>]
   [-WhatIf]
   [<CommonParameters>]

Description

É possível desabilitar as Respostas Automáticas em uma caixa de correio ou organização específica.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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.

Examples

Exemplo 1

Set-MailboxAutoReplyConfiguration -Identity tony -AutoReplyState Scheduled -StartTime "7/10/2018 08:00:00" -EndTime "7/15/2018 17:00:00" -InternalMessage "Internal auto-reply message"

Este exemplo configura as Respostas Automáticas na caixa de correio de Tony para serem enviadas entre as datas de início e de término especificadas e inclui uma mensagem interna.

Exemplo 2

Set-MailboxAutoReplyConfiguration -Identity tony -AutoReplyState Enabled -InternalMessage "Internal auto-reply message." -ExternalMessage "External auto-reply message."

Este exemplo configura as Respostas Automáticas para a caixa de correio de Tony para que sejam enviadas e inclui uma mensagem interna e uma externa.

Parameters

-AutoDeclineFutureRequestsWhenOOF

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

O parâmetro AutoDeclineFutureRequestsWhenOOF especifica quando recusar automaticamente novas solicitações de reunião que foram enviadas para a caixa de correio durante o período agendado quando as Respostas Automáticas estão sendo enviadas. Os valores válidos são:

  • $true: novas solicitações de reunião recebidas durante o período de tempo agendada são automaticamente recusadas.

  • $false: as solicitações de reunião recebidas durante o período de tempo agendado não são automaticamente recusadas. Esse é o valor padrão.

Só é possível usar esse parâmetro quando o parâmetro AutoReplyState está definido como Scheduled.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-AutoReplyState

O parâmetro AutoReplyState especifica se a caixa de correio será habilitada para Respostas Automáticas. Os valores válidos são:

  • Habilitado: as respostas automáticas são enviadas para a caixa de correio.

  • Disabled: as respostas automáticas não são enviadas para a caixa de correio. Esse é o valor padrão.

  • Agendada: as respostas automáticas são enviadas para a caixa de correio durante o período de tempo especificado pelos parâmetros StartTime e EndTime.

Os valores Enabled e Scheduled exigem estas configurações adicionais:

  • Um valor para o parâmetro InternalMessageValue.

  • Um valor para o parâmetro ExternalMessageValue se o parâmetro ExternalAudience estiver definido como conhecido ou como todos.

Type:OofState
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-CreateOOFEvent

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

O parâmetro CreateOOFEvent especifica quando criar um evento de calendário que corresponde ao período agendado quando as Respostas Automáticas são enviadas para a caixa de correio. Os valores válidos são:

  • $true: quando você configura um período de tempo agendado para respostas automáticas usando o valor agendado para o parâmetro AutoReplyState, um evento de calendário é criado na caixa de correio para essas datas. Você pode especificar o assunto do evento usando o parâmetro OOFEventSubject.

  • $false: quando você configura um período de tempo agendado para respostas automáticas usando o valor agendado para o parâmetro AutoReplyState, nenhum evento de calendário é criado para essas datas. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DeclineAllEventsForScheduledOOF

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

O parâmetro DeclineAllEventsForScheduledOOF especifica quando recusar todos os eventos de calendário existentes na caixa de correio durante o período agendado quando as Respostas Automáticas estão sendo enviadas. Os valores válidos são:

  • $true: eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendado são recusados e removidos do calendário.

  • $false: eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendados permanecem no calendário. Esse é o valor padrão.

Só é possível usar esse parâmetro quando o parâmetro DeclineEventsForScheduledOOF está definido como $true.

Não é possível usar esse parâmetro com o parâmetro EventsToDeleteIDs.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DeclineEventsForScheduledOOF

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

O parâmetro DeclineEventsForScheduledOOF especifica quando recusar os eventos de calendário existentes na caixa de correio durante o período agendado quando as Respostas Automáticas estão sendo enviadas. Os valores válidos são:

  • $true: eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendado podem ser recusados e removidos do calendário. Para recusar eventos específicos durante o período de tempo agendado, use o parâmetro EventsToDeleteIDs. Para recusar todos os eventos durante o período de tempo agendado, use o parâmetro DeclineAllEventsForScheduledOOF.

  • $false: eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendados permanecem no calendário. Esse é o valor padrão.

Só é possível usar esse parâmetro quando o parâmetro AutoReplyState está definido como Scheduled.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DeclineMeetingMessage

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

O parâmetro DeclineMeetingMessage especifica o texto na mensagem quando as solicitações de reuniões que foram enviadas para a caixa de correio são recusadas automaticamente. Por exemplo:

  • O parâmetro AutoDeclineFutureRequestsWhenOOF está definido como $true.

  • O parâmetro DeclineEventsForScheduledOOF é definido como $true e o parâmetro DeclineAllEventsForScheduledOOF é definido como $true ou eventos individuais são especificados usando o parâmetro EventsToDeleteIDs.

Se o valor contiver espaços, coloque-o entre aspas ("). As marcas HTML não são adicionadas automaticamente ao texto, mas você pode usar os valores que contêm marcas HTML. Por exemplo, "Estou <html> <body> em férias. <br> Não consigo participar da reunião. </body> </html> ".

Para limpar o valor deste parâmetro, use o valor $null.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-EndTime

O parâmetro EndTime especifica a data e hora de término do envio de Respostas Automáticas para a caixa de correio. Você usará esse parâmetro apenas quando o parâmetro AutoReplyState for definido para Scheduled, e o valor desse parâmetro será significativo apenas quando AutoReplyState for Scheduled.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-EventsToDeleteIDs

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

O parâmetro EventsToDeleteIDs especifica os eventos do calendário para excluir da caixa de correio quando o parâmetro DeclineEventsForScheduledOOF está definido como $true.

Você pode especificar vários eventos de calendário separados por vírgulas.

Não é possível usar esse parâmetro com o parâmetro DeclineAllEventsForScheduledOOF.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ExternalAudience

O parâmetro ExternalAudience especifica se as Respostas Automáticas são enviadas para remetentes externos. Os valores válidos são:

  • Nenhum: as respostas automáticas não são enviadas para remetentes externos.

  • Conhecido: as respostas automáticas são enviadas apenas para remetentes externos que estão especificados na lista de contatos da caixa de correio.

  • All: as respostas automáticas são enviadas para todos os remetentes externos. Esse é o valor padrão.

O valor desse parâmetro será significativo apenas quando o parâmetro AutoReplyState for definido para Enabled ou Scheduled.

Type:ExternalAudience
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-ExternalMessage

O parâmetro ExternalMessage especifica a mensagem de Respostas Automáticas que será enviada para remetentes externos ou remetentes de fora da organização. Se o valor contiver espaços, coloque-o entre aspas (").

As marcas HTML serão adicionadas automaticamente ao texto. Por exemplo, se você inserir o texto "Estou em férias", o valor se tornará automaticamente: Estou <html> <body> em férias </body> </html> . As marcas HTML adicionais serão permitidas se você colocar o valor entre aspas. Por exemplo, "Estou <html> <body> em férias. <br> Responderei quando retornar. </body> </html> ".

O valor desse parâmetro será significativo apenas quando ambas as condições a seguir forem verdadeiras:

  • O parâmetro AutoReplyState estiver definido como Enabled ou Scheduled.

  • O parâmetro ExternalAudience estiver definido como Known ou All.

Para limpar o valor desse parâmetro quando ele não for mais necessário (por exemplo, se você alterar o parâmetro ExternalAudience para None), use o valor $null.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Identity

O parâmetro Identity especifica a caixa de correio que você deseja modificar. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • <domain name>\<account name>

  • DN canônico

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

Type:MailboxIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IgnoreDefaultScope

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite ao comando acessar os objetos do Active Directory que não estão atualmente disponíveis no escopo padrão.

O uso do parâmetro IgnoreDefaultScope apresenta as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-InternalMessage

O parâmetro InternalMessage especifica a mensagem de Respostas Automáticas que será enviada para remetentes internos ou remetentes de dentro da organização. Se o valor contiver espaços, coloque-o entre aspas (").

As marcas HTML serão adicionadas automaticamente ao texto. Por exemplo, se você inserir o texto: "Estou em férias", o valor se tornará automaticamente: Estou <html> <body> em férias </body> </html> . As marcas HTML adicionais serão permitidas se você colocar o valor entre aspas. Por exemplo, "Estou <html> <body> em férias. <br> Entre em contato com o meu gerente. </body> </html> ".

O valor desse parâmetro será significativo apenas quando o parâmetro AutoReplyState for definido para Enabled ou Scheduled.

Para limpar o valor desse parâmetro quando ele não for mais necessário (por exemplo, se você alterar o parâmetro AutoReplyState para Disabled), use o valor $null.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-OOFEventSubject

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

O parâmetro OOFEventSubject especifica o assunto para o evento de calendário que é criado automaticamente quando o parâmetro CreateOOFEvent está definido como $true.

Se o valor contiver espaços, coloque-o entre aspas ("). Para limpar o valor deste parâmetro, use o valor $null.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-StartTime

O parâmetro StartTime especifica a data e hora de início do envio de Respostas Automáticas para a caixa de correio especificada. Você usará esse parâmetro apenas quando o parâmetro AutoReplyState for definido para Scheduled, e o valor desse parâmetro será significativo apenas quando AutoReplyState for Scheduled.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.