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 |
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:
|
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"