Agregar una entrada de función a una función

Artículo
05/13/2016

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

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

Si desea permitir el acceso a cmdlet, necesitará agregar la entrada de la función de administración asociada a la función de administración. Después de agregar la entrada de función a la función, los usuarios asignados a la función podrán tener acceso a 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 puede agregar entradas de función a las funciones integradas. Si desea personalizar funciones, debe crear una nueva función. Para obtener información acerca de cómo crear una función nueva, vea Crear una función.

Debe usar el Shell para agregar entradas de función a una función.

Nota

Este tema no describe cómo agregar entradas de administración sin ámbito a una función de administración sin ámbito. Para obtener más información acerca de cómo crear entradas de función sin ámbito, consulte Agregar una entrada de función a una función de nivel superior sin ámbito.

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

Requisitos previos

Una entrada de función que desea agregar a una función de administración debe existir en esa función de administración principal inmediata de la función.
Este tema hace uso de canalización. Para obtener más información acerca de la canalización, consulte Canalización.

¿Qué desea hacer?

Agregar una entrada de función única de una función primaria
Agregar una entrada de función única de una función primaria e incluir solamente parámetros específicos
Agregar varias entradas de la función de una función primaria

Nota

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

Agregar una entrada de función única de una función primaria

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.

Puede agregar una entrada de función a una función exactamente como aparece en la función primaria al utilizar la siguiente sintaxis.

Add-ManagementRoleEntry <child role name>\<cmdlet>

En este ejemplo, se agrega el cmdlet de Set-Mailbox a la función de administradores de destinatarios.

Add-ManagementRoleEntry "Recipient Administrators\Set-Mailbox"

Este comando comprueba la función principal y, si la entrada de la función existe, la agrega a la función secundaria. Si la entrada de la función ya existe en la función secundaria, puede incluir el parámetro Overwrite para sobrescribir la entrada de función existente.

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

Agregar una entrada de función única de una función primaria e incluir solamente parámetros específicos

Si desea agregar una entrada de función de una función primaria, pero desea incluir solamente parámetros específicos en la entrada de función en la función secundaria, utilice la siguiente sintaxis.

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

En este ejemplo, se agrega el cmdlet Set-Mailbox a la función de Servicio de asistencia, pero incluye solamente los parámetros DisplayName y EmailAddresses en la entrada en la función secundaria.

Add-ManagementRoleEntry "Help Desk\Set-Mailbox" -Parameters DisplayName, EmailAddresses

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

Agregar varias entradas de la función de una función primaria

Si desea agregar más de una entrada de función a una función, deberá recuperar una lista de las entradas de la función que existe en la función primaria que desea agregar a la función secundaria, y luego, agregarlas a la función secundaria. Para hacer esto, debe recuperar la lista de las entradas de función en una función primaria al usar el cmdlet Get-ManagementRoleEntry. A continuación, canalice los resultados del cmdlet Get-ManagementRoleEntry al cmdlet Add-ManagementRoleEntry. Para recuperar varias entradas de la función, deberá utilizar el carácter comodín (*).

Para agregar múltiples entradas de una función primaria a una función secundaria, use la siguiente sintaxis.

Get-ManagementRoleEntry <parent role name>\*<partial cmdlet name>* | Add-ManagementRoleEntry -Role <child role name>

En este ejemplo, se agrega todas las entradas de la función que contiene la cadena Mailbox en el nombre de cmdlet en la función primaria de Destinatarios de correo a la función secundaria de Destinatarios de correo de Seattle.

Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Seattle Mail Recipients"

Si las entradas de la función ya existen en la función secundaria, puede incluir el parámetro Overwrite para sobrescribir las entradas de función existentes.

Para obtener más información acerca de cómo recuperar una lista de entradas de la función de administración, vea Ver las entradas de funciones.

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