Compartilhar via

Set-Group (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-17

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

Sintaxe

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

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

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-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 dinâmicos de distribuição, use o cmdlet Set-DynamicDistributionGroup. Para obter mais informações sobre o cmdlet Set-DynamicDistributionGroup, consulte Set-DynamicDistributionGroup (RTM).

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.

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.

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.

Anotações

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.

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"