Set-OfflineAddressBook (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-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[]>] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]

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

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 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	Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome do catálogo de endereços offline que representa um catálogo específico de endereços offline. 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 o nome do catálogo de endereços offline 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.
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 nome de domínio totalmente qualificado (FQDN) 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 parâmetro Name pode incluir 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 Server 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.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

Este exemplo altera o nome do catálogo de endereços offline.

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