Compartilhar via

New-OfflineAddressBook (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet New-OfflineAddressBook para criar um novo OAB (catálogo de endereços offline).

Sintaxe

New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]

Descrição detalhada

O cmdlet New-OfflineAddressBook permite que os administradores criem novos OABs. Por exemplo, se você desinstalar um servidor de Acesso para Cliente que contenha um OAB, precisará recriá-lo em outro servidor de Acesso para Cliente.

Para executar o cmdlet New-OfflineAddressBook, você deve usar uma conta à qual estejam delegadas as seguintes funções:

  • 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

AddressLists

Necessário

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

O parâmetro AddressLists especifica uma matriz de identidades da lista de endereços incluídas no OAB.

Name

Necessário

System.String

O parâmetro Name especifica o nome que descreve o objeto OAB no Gerenciador do Sistema do Exchange (até 64 caracteres).

Server

Necessário

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor no qual o novo OAB será criado.

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

O parâmetro DomainController especifica o controlador de domínio a ser usado para a criação do OAB.

IsDefault

Opcional

System.Boolean

Se o valor do parâmetro IsDefault for $true, o OAB será definido como o OAB padrão para todos os novos bancos de dados de caixa de correio. Se o valor for $false, o OAB não será definido como o OAB padrão.

PublicFolderDatabase

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro PublicFolderDatabase especifica a identidade de um banco de dados de pasta pública.

PublicFolderDistributionEnabled

Opcional

System.Boolean

Se o valor do parâmetro PublicFolderDistributionEnabled for $true, o OAB será distribuído por meio de pastas públicas.

Schedule

Opcional

Microsoft.Exchange.Data.Schedule

O parâmetro Schedule especifica o intervalo agendado para gerar o novo 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].

TemplateInstance

Opcional

System.Management.Automation.PSObject

O parâmetro TemplateInstance especifica o modelo usado para criar o novo OAB.

Versions

Opcional

System.Collections.ObjectModel.Collection

O parâmetro Versions especifica a versão do OAB a ser gerada. Os valores permitidos são:

  • Version1

  • Version2

  • Version3

  • Version4

VirtualDirectories

Opcional

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]

O parâmetro VirtualDirectories especifica a matriz de objetos OABVirtualDirectory. Se o parâmetro VirtualDirectories for especificado, a Version4 do OAB deverá ser gerada.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Este exemplo usa dois comandos para criar um novo OAB chamado OfflineAddressBook que inclui todas as listas de endereços disponíveis na organização. Com as configurações mostradas, um OAB é gerado por myserver.contoso.com às segundas e quartas-feiras de 1 às 2 da manhã. O comando cria também o OAB padrão para a organização.

$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"