Compartilhar via

Get-StorageGroup

  • Artigo

 

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

Tópico modificado em: 2007-07-05

Use o cmdlet Get-StorageGroup para recuperar o objeto de um grupo de armazenamento no serviço de diretório do Active Directory.

Sintaxe

Get-StorageGroup [-Identity <StorageGroupIdParameter>] [-DomainController <Fqdn>] [-IncludePreExchange2007 <SwitchParameter>] [-Status <SwitchParameter>]

Get-StorageGroup -Server <ServerIdParameter> [-DomainController <Fqdn>] [-IncludePreExchange2007 <SwitchParameter>] [-Status <SwitchParameter>]

Descrição detalhada

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

  • Função Administrador Somente para Exibição do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Server

Necessário

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o nome do servidor para consulta de grupos de armazenamento. Esse parâmetro pode ser usado em vez do parâmetro Identity se você desejar recuperar todos os objetos do grupo de armazenamento para o servidor.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando. Devido a atrasos na replicação do Active Directory, diferentes servidores do Active Directory poderão retornar diferentes valores se um novo grupo de armazenamento tiver sido criado recentemente.

Identity

Opcional

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.

IncludePreExchange2007

Opcional

System.Management.Automation.SwitchParameter

Se o valor do parâmetro IncludeExchange2003Servers for $true, esse parâmetro retornará informações sobre as versões anteriores do Exchange, além do Exchange Server 2007.

Status

Opcional

System.Management.Automation.SwitchParameter

Use o parâmetro Status para exibir três propriedades de grupo de armazenamento relativas a LCR ou CCR:

  • CanEnableLocalCopy

  • CanRunDefaultUpdate

  • CanRunRestore

As propriedades de status podem ter os seguintes valores:

  • CanEnableLocalCopy

  • Inválida

  • CanBeEnabled

  • DatabaseEnabled

  • AlreadyEnabled

  • CanRunDefaultUpdate

  • Inválida

  • NotLocal

  • NotSuspended

  • Permitido

  • CanRunRestore

  • Inválida

  • NotLocal

  • Permitido

Para obter informações sobre como usar o parâmetro Status, consulte "Exemplo" posteriormente neste tópico.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

  

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo de código é um exemplo do comando Get-StorageGroup. Nesse exemplo, a saída do comando Get-StorageGroup é canalizada para o comando Format-List para que todas as informações disponíveis sejam exibidas no resultado.

O segundo exemplo de código demonstra o uso do parâmetro Status.

Get-StorageGroup -Identity "Storage Group Server\First Storage Group" | Format-List
Get-StorageGroup -Status | FT -Autosize Name, CanEnableLocalCopy, CanRunRestore, CanRunDefaultUpdate