Compartilhar via


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