New-OfflineAddressBook

 

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

Tópico modificado em: 2008-01-21

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> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

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.
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.
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].
SkipPublicFolderInitialization	Opcional	System.Management.Automation.SwitchParameter	Se você estiver criando um OAB que utiliza distribuição de pasta pública, use o parâmetro SkipPublicFolderInitialization para ignorar a criação imediata das pastas públicas OAB. O OAB não estará disponível para download até que o próximo ciclo de manutenção de pasta do site seja concluído. Você não precisa especificar nenhum valor com o parâmetro SkipPublicFolderInitialization. A omissão desse parâmetro pode causar a pausa da tarefa enquanto ela contata o servidor de pasta pública responsável para criar as pastas públicas necessárias. Se o servidor estiver inacessível no momento ou caso o contato seja dispendioso, a pausa poderá ser significativa.
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.
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

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"