Compartilhar via


Set-MailboxAutoReplyConfiguration

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

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.

Sintaxe

Default (Default)

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 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-MailboxAutoReplyConfiguration -Identity tony@contoso.com -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 para que a caixa de correio do João seja enviada entre as datas de início e de fim especificadas e inclui uma resposta interna.

Exemplo 2

Set-MailboxAutoReplyConfiguration -Identity tony@contoso.com -AutoReplyState Enabled -InternalMessage "Internal auto-reply message." -ExternalMessage "External auto-reply message." -ExternalAudience All

Este exemplo configura as Respostas Automáticas para que a caixa de correio do João seja enviada, especifica a resposta para mensagens de remetentes internos e externos e especifica que a resposta externa é enviada para qualquer endereço externo.

Parâmetros

-AutoDeclineFutureRequestsWhenOOF

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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: os novos pedidos de reunião recebidos durante o período de tempo agendado são automaticamente recusados.
  • $false: os pedidos de reunião recebidos durante o período de tempo agendado não são recusados automaticamente. Este valor é a predefinição.

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

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

-AutoReplyState

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

  • Ativado: as Respostas Automáticas são enviadas para a caixa de correio.
  • Desativado: as Respostas Automáticas não são enviadas para a caixa de correio. Este valor é a predefinição.
  • Agendadas: 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 Tudo.

Propriedades do parâmetro

Tipo:OofState
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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio

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 estes cmdlets, você pode pular o pedido 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.

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

-CreateOOFEvent

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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 configura um período de tempo agendado para Respostas Automáticas com o valor Agendado para o parâmetro AutoReplyState, é criado um evento de calendário na caixa de correio dessas datas. Você pode especificar o assunto do evento usando o parâmetro OOFEventSubject.
  • $false: quando configura um período de tempo agendado para Respostas Automáticas utilizando o valor Agendado para o parâmetro AutoReplyState, não é criado nenhum evento de calendário para essas datas. 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

-DeclineAllEventsForScheduledOOF

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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: os 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. Se a caixa de correio for o organizador da reunião, os eventos serão cancelados para todos os outros participantes.
  • $false: os eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendado permanecem no calendário. Este valor é a predefiniçã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.

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

-DeclineEventsForScheduledOOF

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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: os 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. Se a caixa de correio for o organizador da reunião, os eventos serão cancelados para todos os outros participantes.

    Para recusar eventos específicos durante o período de tempo agendado, utilize o parâmetro EventsToDeleteIDs. Para recusar todos os eventos durante o período de tempo agendado, utilize o parâmetro DeclineAllEventsForScheduledOOF.

  • $false: os eventos de calendário existentes na caixa de correio que ocorrem durante o período de tempo agendado permanecem no calendário. Este valor é a predefinição.

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

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

-DeclineMeetingMessage

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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 está definido como $true e o parâmetro DeclineAllEventsForScheduledOOF está definido como $true ou os eventos individuais são especificados através do 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, "<html><body>I'm on vacation. <b>I can't attend the meeting.</b></body></html>".

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

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

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Fqdn
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

-EndTime

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Propriedades do parâmetro

Tipo:DateTime
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

-EventsToDeleteIDs

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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.

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

-ExternalAudience

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

  • Nenhuma: as Respostas Automáticas não são enviadas para remetentes externos.
  • Conhecidas: as Respostas Automáticas são enviadas apenas para remetentes externos especificados na Lista de contactos da caixa de correio.
  • Tudo: as Respostas Automáticas são enviadas para todos os remetentes externos. Este valor é a predefinição.

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

Propriedades do parâmetro

Tipo:ExternalAudience
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

-ExternalMessage

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 introduzir o texto "Estou de férias", o valor torna-se automaticamente: <html><body>I'm on vacation</body></html>. As marcas HTML adicionais serão permitidas se você colocar o valor entre aspas. Por exemplo, "<html><body><b>I'm on vacation</b>. I'll respond when I return.</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.

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

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio

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)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-IgnoreDefaultScope

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.

Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, mas também introduz 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.

Propriedades do parâmetro

Tipo:SwitchParameter
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

-InternalMessage

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 introduzir o texto: "Estou de férias", o valor torna-se automaticamente: <html><body>I'm on vacation</body></html>. As marcas HTML adicionais serão permitidas se você colocar o valor entre aspas. Por exemplo, "<html><body>I'm on vacation. <b>Please contact my manager.</b></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.

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

-OOFEventSubject

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional 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.

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

-StartTime

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Propriedades do parâmetro

Tipo:DateTime
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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio

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.

Entradas

Input types

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.

Saídas

Output types

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.