Set-StorageGroup

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Set-StorageGroup para definir os atributos de um grupo de armazenamento no serviço de diretório do Active Directory.

Sintaxe

Set-StorageGroup -Identity <StorageGroupIdParameter> [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]

Set-StorageGroup [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <StorageGroup>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]

Descrição detalhada

Para executar o cmdlet Set-StorageGroup, você deve usar uma conta à qual esteja delegado o seguinte:

• Função de Administrador do Exchange Server e grupo Administradores local para o 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.StorageGroupIdParameter	Use o parâmetro Identity para especificar a GUID ou o nome distinto que representa um grupo de armazenamento específico. Você também pode incluir o nome do servidor usando o formato ServerName\StorageGroup. O rótulo do parâmetro Identity é opcional.
CircularLoggingEnabled	Opcional	System.Boolean	O parâmetro CircularLoggingEnabled habilita o log circular com um valor $true. O valor padrão é $false.
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	Para especificar o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.StorageGroup	O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.
Name	Opcional	System.String	O parâmetro Name define o novo nome do grupo de armazenamento.
ZeroDatabasePages	Opcional	System.Boolean	O parâmetro ZeroDatabasePages permite zerar as páginas excluídas com o valor $true. O valor padrão é $false.
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

O código a seguir é um exemplo do comando Set-StorageGroup que renomeia Storage_Group_1 para "MyStorageGroup".

Set-StorageGroup -Identity  "Exchange-Server-1.Contoso.com\StorageGroup-1" -Name MyStorageGroup