Scripts para gerenciamento de pastas públicas no Shell de Gerenciamento do Exchange
Artigo
Aplica-se a: Exchange Server 2010
Tópico modificado em: 2009-10-22
A execução de scripts no Shell de Gerenciamento do Exchange pode agilizar e facilitar a administração de pastas públicas automatizando tarefas complexas ou frequentemente executadas. Você pode usar scripts instalados com o Microsoft Exchange Server 2010 e descritos neste tópico (bem como outros scripts) ou pode escrever seus próprios scripts.
Dica
O Shell não carrega scripts automaticamente. Você deve preceder todos os scripts com .</STRONG> (um ponto, seguido por uma barra invertida). Por exemplo, para executar o script AggregatePFData.ps1, digite .\AggregatePFData.ps1.
Por padrão, a coleção de scripts do Shell descrita neste tópico é instalada em <Caminho de Instalação do Exchange>\v14\ Server\Scripts.
Procurando outras tarefas de gerenciamento relacionadas a pastas públicas? Consulte Gerenciando pastas públicas.
Scripts Administrativos
A tabela a seguir lista os scripts administrativos incluídos no Exchange 2010.
Tarefa
Script
Descrição
Adicionar um servidor à lista de replicação.
AddReplicaToPFRecursive.ps1
Esse script adiciona um novo servidor à lista de replicação de uma pasta pública e todas as pastas abaixo dela na hierarquia. Se o servidor já estiver relacionado na lista de replicação de uma pasta, nada será alterado para essa pasta. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que tenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
ServerToAdd (Necessário) Esse parâmetro especifica a identidade do servidor a ser adicionada à lista de réplicas. Esse servidor deve conter um banco de dados de pasta pública.
Agregar dados de todas as réplicas de pasta pública.
AggregatePFData.ps1
Este script agrega e captura informações coletadas pelos seguintes cmdlets:
Get-PublicFolderItemStatistics
Get-PublicFolderStatistics
Get-PublicFolder
As informações a seguir são agregadas em nível de pasta pública, e não em nível de item:
Último acesso de usuário e últimos horários de modificação do usuário
Proprietário da pasta pública
Outras propriedades como MailEnabled, HasRules, ItemCount, FolderType, HasModerator e TotalItemSize
O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Pasta Pública (Necessário) Esse parâmetro especifica a identidade da pasta pública.
Esse script remove um servidor da lista de replicação de uma pasta pública e todas as pastas abaixo dela na hierarquia.
Se o servidor não estiver relacionado na lista de replicação de uma pasta, nada será alterado para essa pasta.
Se o servidor for o único servidor na lista de replicação, a lista não será alterada. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que tenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
ServerToRemove Esse parâmetro especifica a identidade do servidor a ser removida da lista de réplicas. Esse servidor deve conter um banco de dados de pasta pública.
Substituir um servidor da lista de replicação.
MoveAllReplicas.ps1
Esse script substitui um servidor por um novo servidor na lista de replicação de todas as pastas públicas, incluindo pastas de sistema. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Necessário) Este parâmetro especifica o servidor a ser removido. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que contenha um banco de dados de pasta pública.
NewServer (Necessário) Esse parâmetro especifica a identidade do servidor a ser adicionada à lista de réplicas. Esse servidor deve conter um banco de dados de pasta pública.
Substituir um servidor da lista de replicação por um novo servidor.
ReplaceReplicaOnPFRecursive.ps1
Esse script substitui um servidor por um novo servidor na lista de replicação de uma pasta pública e todas as pastas abaixo dela na hierarquia. Se o servidor que você deseja remover não estiver relacionado na lista de replicação de uma determinada pasta, nada será alterado para essa pasta. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que contenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
ServerToRemove Esse parâmetro especifica a identidade do servidor a ser removida da lista de réplicas. Esse servidor deve conter um banco de dados de pasta pública.
ServerToRemove (Necessário) Esse parâmetro especifica a identidade do servidor a ser removido da lista de réplicas. Esse servidor deve conter um banco de dados de pasta pública.
Scripts de gerenciamento de usuário
A tabela a seguir lista os scripts de gerenciamento de usuário incluídos no Exchange 2010.
Tarefa
Script
Descrição
Adicionar um usuário à lista de permissões de cliente.
AddUsersToPFRecursive.ps1
Esse script adiciona um usuário e as permissões desse usuário à lista de permissões de cliente de uma pasta pública e todas as pastas abaixo dela na hierarquia. Se o usuário já estiver relacionado na lista de permissões de cliente de uma pasta, as permissões de usuário serão atualizadas para o novo conjunto especificado no script. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que contenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
User (Necessário) Esse parâmetro especifica a identidade do usuário a quem serão adicionadas permissões de cliente.
Permissions (Necessário) Esse parâmetro especifica as permissões de cliente a serem aplicadas ao usuário.
Substituir um usuário por um novo usuário na lista de permissões de cliente.
ReplaceUserWithUserOnPFRecursive.ps1
Esse script substitui um usuário por um novo usuário na lista de permissões de cliente de uma pasta pública e todas as pastas abaixo dela na hierarquia. As permissões existentes para o primeiro usuário são retidas. As pastas públicas que não contenham permissões para o usuário não são modificadas. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que tenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
UserOld (Necessário) Esse parâmetro especifica a identidade do usuário de quem serão removidas permissões de cliente.
UserNew (Necessário) Esse parâmetro especifica a identidade do usuário a quem serão adicionadas permissões de cliente.
Substituir as permissões de um usuário.
ReplaceUserPermissionOnPFRecursive.ps1
Esse script substitui as permissões de um usuário na lista de permissões de cliente de uma pasta pública por um novo conjunto de permissões. Ele também substitui as permissões de todas as pastas na hierarquia abaixo dessa pasta. As pastas públicas que não contenham permissões para o usuário não são modificadas. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que contenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
User (Necessário) Esse parâmetro especifica a identidade do usuário de quem serão substituídas permissões de cliente.
Permissions (Necessário) Esse parâmetro especifica as permissões de cliente a serem aplicadas ao usuário.
Remover um usuário da lista de permissões de cliente.
RemoveUserFromPFRecursive.ps1
Esse script remove um usuário da lista de permissões de cliente de uma pasta pública e todas as pastas abaixo dela na hierarquia. O script aceita os seguintes parâmetros:
Help Esse parâmetro exibe o arquivo de Ajuda do script.
Server (Opcional) Esse parâmetro especifica o servidor com o qual deverá operar. Esse servidor deve ser um servidor de Caixa de Correio do Exchange que contenha um banco de dados de pasta pública. Se você não usar o parâmetro Server para especificar um servidor, o script usará o servidor local como padrão.
TopPublicFolder (Necessário) Esse parâmetro especifica a identidade da pasta na parte superior da árvore de pasta pública.
User (Necessário) Esse parâmetro especifica a identidade do usuário de quem serão removidas as permissões de cliente.
Observação:
Os usuários Padrão e Anônimo não podem ser removidos da lista de permissões. Qualquer tentativa de fazer isso substituirá suas permissões por Nenhuma.