Compartilhar via


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.