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.
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.
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 Respostas Automáticas para a caixa de correio do Tony a ser enviada entre as datas de início e término 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 AllEste exemplo configura Respostas Automáticas para a caixa de correio do Tony a ser 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
Esse parâmetro é funcional apenas 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 agendado são recusadas automaticamente.
- $false: as solicitações de reunião recebidas durante o período agendado não são recusadas automaticamente. 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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: respostas automáticas são enviadas para a caixa de correio.
- Desabilitado: respostas automáticas não são enviadas para a caixa de correio. Esse é o valor padrão.
- Agendado: 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 for definido como Conhecido ou Todos.
| Type: | OofState |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CreateOOFEvent
Esse parâmetro é funcional apenas 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineAllEventsForScheduledOOF
Esse parâmetro é funcional apenas 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 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 agendado 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineEventsForScheduledOOF
Esse parâmetro é funcional apenas 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 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 agendado, use o parâmetro EventsToDeleteIDs. Para recusar todos os eventos durante o período agendado, use o parâmetro DeclineAllEventsForScheduledOOF.
$false: Os eventos de calendário existentes na caixa de correio que ocorrem durante o período agendado 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineMeetingMessage
Esse parâmetro é funcional apenas 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 é 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, "<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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 é funcional apenas 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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:
- Nenhuma: respostas automáticas não são enviadas para remetentes externos.
- Conhecido: Respostas automáticas são enviadas apenas para remetentes externos especificados na lista Contato da caixa de correio.
- Tudo: 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 |
| Required: | False |
| 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 de férias", o valor se tornará 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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\username
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.
Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 de férias", o valor se tornará 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 é funcional apenas 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.