Compartir a través de

Set-Group (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-17

Utilice el cmdlet Set-Group para modificar la configuración de un grupo de Microsoft Windows existente.

Sintaxis

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>]

Descripción detallada

Puede utilizar el cmdlet Set-Group para modificar la configuración de los objetos del grupo que están visibles en Usuarios y equipos de Active Directory. Si el grupo es un grupo de seguridad habilitado para correo o un grupo de distribución, puede usar el cmdlet Set-DistributionGroup para modificar otra configuración de Microsoft Exchange Server 2007 que no esté disponible con el cmdlet Set-Group.

No puede utilizar el cmdlet Set-Group para modificar los grupos de distribución dinámicos. Para modificar grupos de distribución dinámicos, utilice el cmdlet Set-DynamicDistributionGroup. Para obtener más información acerca del cmdlet Set-DynamicDistributionGroup, consulte Set-DynamicDistributionGroup (RTM).

Para ejecutar el cmdlet Set-Group, debe utilizar una cuenta en la que se delegue lo siguiente:

  • Función Administrador de destinatarios de Exchange

  • Función de operador de cuentas para los contenedores Active Directory correspondientes 

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

El parámetro Identity especifica el objeto que desea modificar. El parámetro Identity puede utilizar cualquiera de los valores siguientes para el grupo:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Name

  • Nombre para mostrar

Identity no se puede utilizar si se ha especificado el parámetro Instance.

DisplayName

Opcional

System.String

El parámetro DisplayName especifica el nombre del grupo en la Consola de administración de Exchange y en la lista global de direcciones (GAL) de Exchange. Este parámetro sólo tiene sentido si el grupo está habilitado para correo.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración para Active Directory, incluya el parámetro DomainController.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts donde hay que pasar un objeto completo al comando.

El parámetro Instance no se puede usar si se ha especificado el parámetro Identity.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

El parámetro ManagedBy especifica el nombre del usuario, el grupo o el contacto que aparece en la ficha Administrado por del objeto Active Directory. Puede utilizar los siguientes valores para este parámetro:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Name

  • Nombre para mostrar

Name

Opcional

System.String

El parámetro Name especifica el nombre del grupo. El parámetro Name especifica el nombre del grupo de Usuarios y equipos de Active Directory y, además, en el campo Nombre de grupo de la Consola de administración de Exchange si se ha habilitado el grupo para utilizar el correo.

Notas

Opcional

System.String

El parámetro Notes especifica las notas que describen el propósito del grupo.

PhoneticDisplayName

Opcional

System.String

El parámetro PhoneticDisplayName especifica la pronunciación del parámetro DisplayName.

La longitud máxima de este valor de parámetro es de 255 caracteres. Para obtener más información acerca del parámetro PhoneticDisplayName, vea Descripción de las búsquedas en los directorios de reconocimiento de voz automático.

SimpleDisplayName

Opcional

System.String

El parámetro SimpleDisplayName muestra una descripción alternativa del objeto cuando sólo se permite un conjunto de caracteres limitado. Este conjunto consta de los caracteres ASCII del 26 al 126, ambos incluidos. SimpleDisplayName sólo tiene significado para los objetos habilitados para correo.

Universal

Opcional

System.Management.Automation.SwitchParameter

El parámetro Universal cambia el ámbito del grupo de global o domain local a universal.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

El parámetro WindowsEmailAddress especifica el valor del campo Correo electrónico del objeto de Active Directory.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El siguiente ejemplo de código muestra cómo se utiliza el comando Set-Group para aplicar los siguientes cambios en un grupo de seguridad global existente denominado "Legal Department":

  • Cambiar el ámbito del grupo a universal.

  • Agregar un valor Notas de verified.

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