Cambiar una entrada de función

 

Se aplica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Última modificación del tema: 2011-03-19

Cada entrada de función de administración en una función de administración representa un solo cmdlet. Al agregar o quitar parámetros de una entrada de función que luego se agrega a una función de administración, se controla si esos parámetros están disponibles en ese cmdlet. Para obtener más información acerca de las entradas de funciones de administración en Microsoft Exchange Server 2010, consulte Descripción de las funciones de administración.

No se pueden modificar las entradas de función en funciones integradas de administración.

Debe usar el Shell para agregar o quitar parámetros de una entrada de función.

Nota

En este tema, no se explica cómo modificar entradas de función de administración sin ámbito en una función de administración sin ámbito. Para obtener más información acerca de cómo modificar entradas de función sin ámbito, consulte Crear una función.

Advertencia

Para agregar o quitar parámetros de una entrada de función, debe usar los parámetros AddParameter o RemoveParameter. Si omite el parámetro AddParameter o RemoveParameter al ejecutar el cmdlet Set-ManagementRoleEntry, solo se incluirán en la entrada de función los parámetros especificados mediante Parameters. Se quitarán todos los demás parámetros de la entrada de función.

¿Está buscando otras tareas de administración relacionadas con funciones? Consulte Administración de permisos avanzados.

Requisitos previos

• Si desea agregar parámetros a una entrada de función, los parámetros que agregue deben existir en la entrada de función de la función principal.

• Los parámetros también deben existir en el cmdlet que especifique.

• Si desea quitar parámetros de una entrada de función, los parámetros que quite no pueden existir en entradas de función de ninguna función secundaria. Debe quitar los parámetros de las entradas de función de las funciones secundarias. Use el procedimiento "Usar el Shell para quitar uno o más parámetros de una entrada de función" que figura más adelante en este tema, a fin de quitar los parámetros de entradas de función de todas las funciones secundarias.

¿Qué desea hacer?

• Usar el Shell para agregar uno o más parámetros a una entrada de función

• Use el Shell para quitar uno o más parámetros de una entrada de función

• Usar el Shell para quitar todos los parámetros de una entrada de función

• Usar el Shell para aplicar un conjunto específico de parámetros

  Nota

  No puede usar la EMC para cambiar una entrada de función.

Usar el Shell para agregar uno o más parámetros a una entrada de función

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Entradas de funciones de administración" en el tema Permisos de administración de funciones.

Para agregar parámetros a una entrada de función, debe especificar los parámetros que desea agregar con el parámetro Parameters. Luego debe especificar el parámetro AddParameter para indicar que desea realizar una operación de adición.

Para agregar parámetros a una entrada de función, use la siguiente sintaxis.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -AddParameter

En este ejemplo, se agregan los parámetros EmailAddresses y Type al cmdlet Set-Mailbox en la función Administradores de destinatarios.

Set-ManagementRoleEntry "Recipient Administrators\Set-Mailbox" -Parameters EmailAddresses, Type -AddParameter

Para obtener información más detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.

Use el Shell para quitar uno o más parámetros de una entrada de función

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Entradas de funciones de administración" en el tema Permisos de administración de funciones.

Para quitar parámetros de una entrada de función, debe especificar los parámetros que desea quitar con el parámetro Parameters. Luego debe especificar el parámetro RemoveParameter para indicar que desea realizar una operación de eliminación.

Para quitar parámetros de una entrada de función, use la siguiente sintaxis.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -RemoveParameter

En este ejemplo, se quitan los parámetros Port, ProtocolLoggingLevel y SmartHostAuthMechanism del cmdlet Set-SendConnector en la función Administrador de servidores de nivel 1.

Set-ManagementRoleEntry "Tier 1 Server Administrators\Set-SendConnector" -Parameters Port, ProtocolLoggingLevel, SmartHostAuthMechanism -RemoveParameter

Para obtener información más detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.

Usar el Shell para quitar todos los parámetros de una entrada de función

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Entradas de funciones de administración" en el tema Permisos de administración de funciones.

Para quitar todos los parámetros de una entrada de función, debe especificar el valor $Null en el parámetro Parameters. No es necesario incluir el parámetro RemoveParameters.

Quitar todos los parámetros de una entrada de función resulta muy útil cuando desea que solo algunos parámetros estén disponibles en un cmdlet y que todos los demás se excluyan. Si no desea que la función tenga acceso a un cmdlet, quite la entrada de función asociada por completo de la función en lugar de quitar solamente los parámetros. Para obtener más información acerca de cómo quitar una entrada de función de una función, consulte Quitar una entrada de función de una función.

Advertencia

No puede deshacer las operaciones en las que se quitan elementos. Si, por error, quita todos los parámetros de una entrada de función, debe agregarlos nuevamente de forma manual.

Para quitar todos los parámetros de una entrada de función, use la siguiente sintaxis.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters $Null 

En este ejemplo, se quitan todos los parámetros del cmdlet Set-CasMailbox en la función Administradores de destinatarios.

Set-ManagementRoleEntry "Recipient Administrators\Set-CasMailbox" -Parameters $Null 

Para obtener información más detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.

Usar el Shell para aplicar un conjunto específico de parámetros

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Entradas de funciones de administración" en el tema Permisos de administración de funciones.

Si desea que se incluya solo un conjunto de parámetros específico en una entrada de función, especifique sólo el parámetro Parameters. No incluya los parámetros AddParameter ni RemoveParameter. Cuando solamente especifica el parámetro Parameters, solo los parámetros que especifique en el comando se incluirán en la entrada de función. El resto de parámetros se quitan.

Para especificar un conjunto de parámetros, use la siguiente sintaxis.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...>

En este ejemplo, se incluyen solo los parámetros Identity, DisplayName, MissedCallNotificationEnabled y PersonalAuthAttendantEnabled en el cmdlet Set-UMMailbox en la función Grupo de destinatarios de Seattle.

Set-ManagementRoleEntry "Seattle Mail Recipients\Set-UMMailbox" -Parameters Identity, DisplayName, MissedCallNotificationEnabled, PersonalAutoAttendantEnabled

Para obtener información más detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.

 © 2010 Microsoft Corporation. Reservados todos los derechos.