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"