Set-ManagedFolder
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2009-05-05
Use o cmdlet Set-ManagedFolder para modificar as configurações de pastas gerenciadas.
Sintaxe
Set-ManagedFolder -Identity <ELCFolderIdParameter> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderName <String>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>] [-WhatIf [<SwitchParameter>]]
Set-ManagedFolder [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderName <String>] [-Instance <ELCFolder>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Use o cmdlet Set-ManagedFolder para modificar os parâmetros especificados de uma pasta gerenciada.
O cmdlet Set-ManagedFolder aceita uma pasta personalizada gerenciada ou uma cadeia de caracteres de identidade como uma entrada de pipeline.
Para executar o cmdlet Set-ManagedFolder, você deve usar a conta à qual esteja delegada a seguinte função:
- 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 |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
O parâmetro Identity especifica o nome, o nome distinto ou a GUID da pasta gerenciada. |
Comment |
Opcional |
System.String |
O parâmetro Comment especifica o comentário padrão do administrador a ser exibido com a pasta no Microsoft Office Outlook 2007. |
Confirm |
Optional |
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 |
Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. |
FolderName |
Opcional |
System.String |
O parâmetro FolderName especifica o nome do objeto de pasta como ele aparecerá nas caixas de correio do usuário. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ELCFolder |
O parâmetro Instance permite que você passe um objeto para o comando a ser processado. Ele é usado principalmente em scripts em que um objeto inteiro deve ser passado para o comando. |
LocalizedComment |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro LocalizedComment especifica comentários localizados do administrador e seus idiomas. Os comentários localizados são exibidos em vez do comentário padrão quando a configuração de idioma de qualquer cliente que exibe comentários corresponde ao idioma especificado para esse valor de parâmetro. Os comentários devem estar no formato ISOLanguageCode:Comment. Por exemplo, -LocalizedComment EN-US:"Este é um comentário localizado em inglês dos Estados Unidos". |
LocalizedFolderName |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro LocalizedFolderName especifica nomes de pastas localizados e seus idiomas. Os nomes de pasta localizados são exibidos em vez do nome de pasta padrão quando a configuração de idioma do Outlook 2007 corresponde a um idioma especificado para esse valor de parâmetro. Os comentários devem estar no formato ISOLanguageCode:Comment. Por exemplo, -LocalizedFolderName EN-US:"Este é um nome de pasta localizado em inglês dos Estados Unidos". |
MustDisplayCommentEnabled |
Opcional |
System.Boolean |
Se o parâmetro MustDisplayCommentEnabled estiver presente e for definido como $true, o parâmetro definirá um sinalizador que será usado por qualquer cliente que exiba comentários e aceite essa configuração. Isso impede que os usuários minimizem um comentário de pasta visível no Outlook 2007 apenas. Se o parâmetro não estiver presente ou estiver definido como $false, os usuários poderão minimizar o comentário. |
Name |
Opcional |
System.String |
O parâmetro Name especifica um nome exclusivo para as configurações de conteúdo. O parâmetro Name não aparece em caixas de correio de usuários. |
StorageQuota |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro StorageQuota especifica o limite de tamanho de armazenamento para a pasta de caixa de correio. Quando o tamanho da pasta exceder esse limite, nenhum outro item poderá ser adicionado. Os tamanhos das caixas de correio podem ser especificados em KB (kilobytes) ou MB (megabytes), por exemplo, como 100 KB ou 5 MB. O parâmetro StorageQuota é válido para pastas personalizadas gerenciadas no Outlook 2007. |
BaseFolderOnly |
Opcional |
System.Boolean |
O parâmetro BaseFolderOnly permite controlar o período de retenção de mensagens de subpastas individuais usando configurações de conteúdo gerenciado. A configuração deste sinalizador para True em uma pasta raiz impede que o assistente de pasta gerenciada aplique a diretiva de caixa de correio ao conteúdo das subpastas da pasta raiz. |
WhatIf |
Optional |
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-ManagedFolder é usado para definir a cota de armazenamento da pasta gerenciada chamada MyManagedFolder como 100 KB.
No segundo exemplo, de três linhas, o uso do parâmetro Instance é demonstrado passando uma instância de uma pasta gerenciada, chamada My Managed Folder, para o comando Set-ManagedFolder para definir um novo comentário.
Set-ManagedFolder MyManagedFolder -StorageQuota 100KB
$a = Get-ManagedFolder "My Managed Folder"
$a.Comment = "This is a comment."
Set-ManagedFolder -Instance $a