Set-Group

  • Artigo

 

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

Tópico modificado em: 2009-05-12

Use o cmdlet Set-Group para modificar as configurações de um grupo existente do Microsoft Windows.

Sintaxe

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Você pode usar o cmdlet Set-Group para modificar as configurações do objeto do grupo que são visíveis em Usuários e Computadores do Active Directory. Se o grupo for um grupo de segurança habilitado para email ou um grupo de distribuição, você poderá usar o cmdlet Set-DistributionGroup para modificar outras configurações do Microsoft Exchange Server 2007 que não estejam disponíveis com o cmdlet Set-Group.

Você não pode usar o cmdlet Set-Group para modificar grupos dinâmicos de distribuição. Para modificar grupos de distribuição dinâmica, use o cmdlet Set-DynamicDistributionGroup.

Para executar o cmdlet Set-Group, você deve usar a conta à qual estejam delegadas as seguintes funções:

  • Função Administrador de Destinatários do Exchange

  • Função de Operador de Conta para os contêineres do Active Directory aplicáveis 

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.GroupIdParameter

O parâmetro Identity especifica o objeto que você deseja modificar. O parâmetro Identity pode obter qualquer um dos seguintes valores para o grupo:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

Identity não poderá ser usado se o parâmetro Instance for especificado.

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.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome do grupo no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange. Esse parâmetro terá importância somente se o grupo estiver habilitado para email.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

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.

O parâmetro Instance não poderá ser usado se o parâmetro Identity estiver especificado.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

O parâmetro ManagedBy especifica o nome do usuário, o grupo ou o contato exibido na guia Gerenciado por do objeto do Active Directory. Você pode usar qualquer um dos valores a seguir para este parâmetro:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

Name

Opcional

System.String

O parâmetro Name especifica o nome do grupo. O parâmetro Name especifica o nome do grupo em Usuários e Computadores do Active Directory e também no campo Nome do Grupo no Console de Gerenciamento do Exchange se o grupo estiver habilitado para email.

Notes

Opcional

System.String

O parâmetro Notes especifica as notas que descrevem a finalidade do grupo.

PhoneticDisplayName

Opcional

System.String

O parâmetro PhoneticDisplayName especifica uma pronúncia fonética do parâmetro DisplayName.

O tamanho máximo desse valor de parâmetro é 255 caracteres. Para obter mais informações sobre o parâmetro PhoneticDisplayName e reconhecimento de fala, consulte Compreendendo pesquisas de diretório de Reconhecimento Automático de Fala.

SimpleDisplayName

Opcional

System.String

O parâmetro SimpleDisplayName exibe uma descrição alternativa do objeto quando somente um conjunto limitado de caracteres for permitido. Esse conjunto limitado de caracteres consiste em caracteres ASCII de 26 a 126, inclusive. SimpleDisplayName tem significado apenas para objetos habilitados para email.

Universal

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Universal altera o escopo do grupo global ou domain local para universal.

UseRusServer

Optional

System.String
noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando a usar o servidor Caixa de Correio especificado no qual o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente do serviço Atendedor do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. O serviço Lista de Endereços pode ser usado para atualizar objetos de destinatário em um domínio usando informações específicas, como a associação na lista de endereços e endereços de email.

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.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro WindowsEmailAddress especifica o valor do campo Email do objeto do Active Directory.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir mostra como usar o comando Set-Group para aplicar as seguintes alterações a um grupo de segurança global existente, chamado "Legal Department":

  • Altere o escopo do grupo para universal.

  • Adicione um valor de Notas igual a verified.

Set-Group -Identity "Legal Department" -Universal -Notes "verified"