Set-OfflineAddressBook

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-07-05

Use o cmdlet Set-OfflineAddressBook para modificar as configurações do catálogo de endereços offline (OAB).

Sintaxe

Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-OfflineAddressBook modifica as configurações de um OAB existente. O OAB não tem valor para usuários que ficam um tempo considerável desconectados da rede. O OAB é um instantâneo de uma ou mais listas de endereços, que os clientes MAPI podem baixar para fornecer acesso às listas de endereços enquanto estão offline.

A geração de um OAB não será interrompida, mesmo se for necessário mais tempo do que foi especificado no parâmetro Schedule.

Para executar o cmdlet Set-OfflineAddressBook, você deve usar a conta à qual esteja delegada a seguinte função:

• 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Identity	Necessário	Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter	Use o parâmetro Identity para especificar a GUID, o nome distinto ou o nome do OAB que representa um OAB específico. Você pode também incluir o caminho utilizando o formato Server\OfflineAddressBookName. Você pode omitir o rótulo do parâmetro Identity para que somente a GUID ou o nome do OAB seja fornecido.
AddressLists	Opcional	Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]	O parâmetro AddressLists especifica uma matriz de identidades da lista de endereços incluídas no OAB.
ApplyMandatoryProperties	Optional	System.Management.Automation.SwitchParameter	Não é possível criar um OAB do Exchange 2007 através do Gerenciador de Sistema do Exchange Server 2003 Exchange. Se um OAB do Exchange 2007 for criado com essa ferramenta, ele será identificado como um OAB herdado, mesmo que resida em um servidor Exchange 2007. Use o parâmetro ApplyMandatoryProperties para modificar as propriedades obrigatórias de um OAB neste estado para corrigir o problema.
Confirm	Optional	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.
DiffRetentionPeriod	Opcional	System.Nullable	O parâmetro DiffRetentionPeriod especifica o período de tempo, em dias, que os arquivos de diferença do OAB são retidos no servidor responsável por gerar o OAB e no servidor de Acesso para Cliente. Para reter os arquivos de diferença do OAB indefinidamente, use o valor Ilimitado.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.OfflineAddressBook	O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.
IsDefault	Opcional	System.Boolean	O parâmetro IsDefault define esse OAB como o OAB padrão para todos os novos armazenamentos de caixa de correio.
Name	Opcional	System.String	O parâmetro Name define o novo nome do OAB. O nome aparece no Console de Gerenciamento do Exchange. Um valor de parâmetro Name   pode conter até 64 caracteres.
PublicFolderDistributionEnabled	Opcional	System.Boolean	A configuração do parâmetro PublicFolderDistributionEnabled como um valor $true define que o OAB será distribuído por meio de pastas públicas. O valor padrão é $true.
Schedule	Opcional	Microsoft.Exchange.Data.Schedule	O parâmetro Schedule especifica o intervalo agendado para a geração do OAB. O parâmetro Schedule assume o seguinte formato e deve incluir um intervalo: Dia da semana.Hora:Minuto [AM/PM]-Dia da semana.Hora:Minuto [AM/PM].
Versions	Opcional	System.Collections.ObjectModel.Collection	O parâmetro Versions especifica as versões do OAB geradas para download do cliente. As opções disponíveis são Version4, Version3 e Version2. Version4 é para clientes Microsoft Office Outlook 2007 ou Office Outlook 2003 com Service Pack 2 (SP2). Version3 é para clientes Outlook com suporte para Unicode. Version2 é para clientes do Microsoft Exchange Server 2007, Exchange 2003, Exchange 2000 Server, e do Exchange Server version 5.5.
VirtualDirectories	Opcional	Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]	O parâmetro VirtualDirectories especifica a matriz de objetos OABVirtualDirectory. Se o parâmetro VirtualDirectories for especificado, Version4 do OAB deverá ser gerado.
WhatIf	Optional	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 nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

Este exemplo altera o nome do OAB.

Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"