New-JournalRule
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-08-13
Use o cmdlet New-JournalRule para criar uma nova regra de diário em um computador em que a função de servidor Transporte de Hub do Microsoft Exchange Server 2007 esteja instalada.
Sintaxe
New-JournalRule -Name <String> -JournalEmailAddress <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet New-JournalRule cria uma regra de diário para ser usada com o agente de Diário.
Por padrão, as novas regras de diário estão habilitadas, a menos que o parâmetro Enabled esteja definido como $False. Para obter mais informações sobre como habilitar uma nova regra de diário criada em um estado desabilitado, consulte Enable-JournalRule.
Para executar o cmdlet New-JournalRule, você deve usar uma conta à qual esteja delegada o seguinte:
- Função Administrador da Organização do Exchange
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
JournalEmailAddress |
Necessário |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Use esse parâmetro para especificar um objeto de destinatário para o qual os relatórios de diário são enviados. |
Name |
Necessário |
System.String |
Use esse parâmetro para especificar o nome da regra de diário. O nome da regra pode ter até 64 caracteres. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. |
Enabled |
Opcional |
System.Boolean |
Use esse parâmetro para especificar se a regra de diário está habilitada ou desabilitada. Se a regra estiver desabilitada, ela não será aplicada a nenhuma mensagem de email. O valor padrão é |
Recipient |
Opcional |
System.Nullable |
Use esse parâmetro para especificar o endereço SMTP de uma caixa de correio, um contato ou um grupo de distribuição para registrar no diário. Se você especificar um grupo de distribuição, todos os destinatários desse grupo de distribuição serão registrados no diário. Todas as mensagens enviadas para ou de um destinatário são registradas no diário. |
Scope |
Opcional |
Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope |
Use este parâmetro para especificar as mensagens de email às quais a regra de diário se aplica. Os valores válidos para este parâmetro são os seguintes:
|
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Quando um objeto existente for fornecido a esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto no servidor local ou de destino. Para obter mais informações, consulte Modelos. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
Exemplo
O exemplo a seguir mostra como criar uma nova regra de diário. A regra se aplica a todas as mensagens de email que passam pelo servidor de Transporte de Hub e que contenham pelo menos um destinatário ou remetente que seja um membro da lista de distribuição brokers@contoso.com.
New-JournalRule -Name "Brokerage Communications" -JournalEmailAddress "Brokers Journal Mailbox" -Scope Global -Recipient brokers@contoso.com -Enabled $True