Set-PublicFolder
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2012-03-26
Use o cmdlet Set-PublicFolder para definir os atributos de pastas públicas.
Sintaxe
Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-LocalReplicaAgeLimit <EnhancedTimeSpan>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-PublicFolder [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <PublicFolder>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Para executar o cmdlet Set-PublicFolder, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino
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 |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter |
Utilize o parâmetro Identity para especificar a GUID ou o nome da pasta pública que representa uma pasta pública específica. Você pode também incluir o caminho utilizando o formato TopLevelPublicFolder\PublicFolder. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da pasta pública ou a GUID seja fornecido. |
AgeLimit |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro AgeLimit especifica o limite global de idade da pasta. As réplicas dessa pasta pública serão excluídas automaticamente quando o limite de idade for excedido. Esse parâmetro é mutuamente exclusivo ao parâmetro UseDatabaseAgeDefaults. |
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. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado. |
HiddenFromAddressListsEnabled |
Opcional |
System.Boolean |
O parâmetro HiddenFromAddressListsEnabled especifica se a pasta pública deve ficar oculta a partir das listas de endereços. |
Instance |
Opcional |
Microsoft.Exchange.Data.Mapi.PublicFolder |
O parâmetro Instance permite que voce passe um objeto inteiro para o comando para ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando. |
IssueWarningQuota |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro IssueWarningQuota especifica o tamanho da pasta pública que acionará um aviso para proprietários de pasta pública informando que a pasta está quase cheia. |
LocalReplicaAgeLimit |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro LocalReplicaAgeLimit especifica o limite de idade da réplica do servidor conectado, se houver. Para remover o limite de idade, defina o valor do parâmetro como "$null". |
MaxItemSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro MaxItemSize especifica o tamanho máximo do item em quilobytes (KB) que pode ser postado. Esse parâmetro é mutuamente exclusivo ao parâmetro UseDatabaseQuotaDefaults. |
Name |
Opcional |
System.String |
O parâmetro Name especifica o nome da pasta pública. |
PerUserReadStateEnabled |
Opcional |
System.Boolean |
O parâmetro PerUserReadStateEnabled especifica a manutenção de dados lidos e não lidos por usuário. |
ProhibitPostQuota |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro ProhibitPostQuota especifica com que tamanho de uma pasta pública os usuários serão notificados de que ela está cheia. Os usuários não podem postar em uma pasta cujo tamanho seja maior do que o valor do parâmetro ProhibitPostQuota. |
Replicas |
Opcional |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter[] |
O parâmetro Replicas especifica uma lista de servidores de Caixa de Correio com a qual replicar essa pasta pública. |
ReplicationSchedule |
Opcional |
Microsoft.Exchange.Data.Schedule |
O parâmetro ReplicationSchedule especifica o agendamento de replicação da pasta no seguinte formato: Dia da semana.Hora:Minuto [AM/PM]-Dia da semana.Hora:Minuto [AM/PM]. Dias da semana podem ser digitados de forma completa ou abreviada. Se preferir usar o horário no formato 24 horas, omita AM/PM. Os formatos podem ser mistos. Exemplo: Sun.1:15 AM-Monday.23:00 Esse parâmetro é mutuamente exclusivo ao parâmetro UseDatabaseReplicationSchedule. |
RetainDeletedItemsFor |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro RetainDeletedItemsFor especifica o tempo de retenção de itens excluídos. Esse parâmetro é mutuamente exclusivo ao parâmetro UseDatabaseRetentionDefaults. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
O parâmetro Server especifica o servidor no qual executar as operações selecionadas. |
UseDatabaseAgeDefaults |
Opcional |
System.Boolean |
O parâmetro UseDatabaseAgeDefaults especifica o uso de limite de idade de banco de dados. |
UseDatabaseQuotaDefaults |
Opcional |
System.Boolean |
O parâmetro UseDatabaseQuotaDefaults especifica o uso de limites de cota de armazenamento público. |
UseDatabaseReplicationSchedule |
Opcional |
System.Boolean |
O parâmetro UseDatabaseReplicationSchedule especifica o agendamento de replicação de pasta pública. |
UseDatabaseRetentionDefaults |
Opcional |
System.Boolean |
O parâmetro UseDatabaseRetentionDefaults especifica o uso de padrões de retenção de banco de dados. |
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
No primeiro exemplo, o comando Set-PublicFolder é usado para alterar uma pasta pública para que ela não use o agendamento de replicação padrão do banco de dados.
No segundo exemplo, o comando Set-PublicFolder é usado para definir o agendamento de replicação para Sempre.
No terceiro exemplo, o comando Set-PublicFolder é usado para definir que a pasta replique somente nos fins de semana.
Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false
Set-PublicFolder "\Customer Service Requests" -ReplicationSchedule Always
Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"
Todos os parâmetros do comando Set-PublicFolder podem aceitar entradas de pipeline para seu argumento e tipo forte.
Quando você define o parâmetro UseDatabaseQuotaDefaults como verdadeiro, os seguintes valores são redefinidos para seus valores padrão:
MaxItemSize
IssueWarningQuota
ProhibitPostQuota
Você não poderá usar o cmdlet Set-PublicFolder para alterar nenhum dos valores a seguir quando o parâmetro UseDatabaseQuotaDefaults for verdadeiro:
MaxItemSize
IssueWarningQuota
ProhibitPostQuota
É por este motivo que os valores não são aplicáveis quando você usa as cotas de banco de dados padrão.
No Exchange Server 2007 Service Pack 2 (SP2), o valor de IssueWarningQuota deve ser menor ou igual ao valor de ProhibitPostQuota. Além disso, o valor de MaxItemSize deve ser menor ou igual ao valor de ProhibitPostQuota.