Scripts para gerenciamento de pastas públicas no Shell de Gerenciamento do Exchange

Artigo
05/13/2016

Aplica-se a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Tópico modificado em: 2015-03-09

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.

Para mais informações sobre como usar e escrever scripts, consulte Script com o Shell de Gerenciamento do Exchange.

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.

Para mais informações, consulte Visualizar as estatísticas de itens de pasta pública.

Remover um servidor da lista de replicação.

RemoveReplicaFromPFRecursive.ps1

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.

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.

Dica

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.

Consulte também

Conceitos

Noções Básicas Sobre Pastas Públicas
Gerenciando pastas públicas

Outros recursos

Usando o PowerShell com o Exchange 2010 (Shell de Gerenciamento do Exchange)

© 2010 Microsoft Corporation. Todos os direitos reservados.

Partilhar via

Scripts para gerenciamento de pastas públicas no Shell de Gerenciamento do Exchange

Scripts Administrativos

Scripts de gerenciamento de usuário

Consulte também

Conceitos

Outros recursos

Recursos adicionais

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. Para mais informações, consulte Visualizar as estatísticas de itens de pasta pública.
Remover um servidor da lista de replicação.	RemoveReplicaFromPFRecursive.ps1	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.

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. Dica 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.