Set-Group
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2009-05-12
Utilice el cmdlet Set-Group para modificar la configuración de un grupo de Microsoft Windows existente.
Sintaxis
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>]
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 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 de Active Directory aplicables
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:
Identity no se puede utilizar si se ha especificado el parámetro Instance. |
||
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
||
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 (FQDN) del controlador de dominio que escribe este cambio de configuración Active Directory, incluya el parámetro DomainController. |
||
IgnoreDefaultScope |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:
|
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.WindowsGroup |
El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts en los que se debe pasar un objeto completo al comando. El parámetro Instance no se puede utilizar 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:
|
||
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. |
||
Notes |
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 una pronunciación fonética del parámetro DisplayName. La longitud máxima del valor de este parámetro es 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 (en inglés). |
||
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 juego limitado de caracteres consta de los caracteres ASCII del 26 al 126, ambos incluidos. SimpleDisplayName sólo tiene sentido para los objetos habilitados para correo. |
||
Universal |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Universal cambia el ámbito del grupo de |
||
UseRusServer |
Opcional |
System.String |
El parámetro UseRusServer indica al comando que use el servidor de buzones especificado en el que se esté ejecutando el servicio Lista de direcciones para obtener y establecer los atributos del buzón y del usuario de Active Directory. El servicio Lista de direcciones es un componente del servicio Operador de sistema de Exchange. El servicio Lista de direcciones crea y mantiene valores de atributo específicos de Exchange en Active Directory. El servicio Lista de direcciones se puede usar para actualizar objetos de destinatario de un dominio mediante el uso de información específica, como la pertenencia a una lista de direcciones y direcciones de correo electrónico. |
||
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
||
WindowsEmailAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro WindowsEmailAddress especifica el valor del campo Correo electrónico del objeto de Active Directory. |
.gif "note")
Nota: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"