Agregar una entrada de función a una función
Se aplica a: Exchange Server 2013
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 2013, consulte Descripción de los roles 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 un rol.
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 Permisos avanzados.
¿Qué necesita saber antes de empezar?
Tiempo estimado para completar cada procedimiento: 5 minutos
Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento o procedimientos. Para ver qué permisos necesita, consulte el Entrada "Funciones de administración" en el tema Permisos de administración de roles.
Debe usar el Shell para hacer este tipo de procedimientos.
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 sobre la canalización, consulte about_Pipelines.
Para obtener información acerca de los métodos abreviados de teclado aplicables a los procedimientos de este tema, consulte Métodos abreviados de teclado en el Centro de administración de Exchange.
Sugerencia
¿Problemas? Solicite ayuda en los foros de Exchange. Visite los foros en Exchange Server.
Agregar una entrada de función única de una función primaria
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 rol ya existe en el rol secundario, puede incluir el parámetro Overwrite para sobrescribir la entrada de rol existente.
Para obtener información 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 al rol De soporte técnico, pero solo se incluyen los parámetros DisplayName y EmailAddresses en la entrada del rol secundario.
Add-ManagementRoleEntry "Help Desk\Set-Mailbox" -Parameters DisplayName, EmailAddresses
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 rol ya existe en el rol secundario, puede incluir el parámetro Overwrite para sobrescribir la entrada de rol existente.
Para obtener información 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 agregan todas las entradas de rol que contienen la cadena Mailbox en el nombre del cmdlet en el rol primario Destinatarios de correo al rol secundario Destinatarios de correo de Seattle.
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Seattle Mail Recipients"
Si las entradas de rol ya existen en el rol secundario, puede incluir el parámetro Overwrite para sobrescribir las entradas de rol 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 entradas de papel.
Para obtener más información acerca de la sintaxis y los parámetros, consulte Get-ManagementRoleEntry y Add-ManagementRoleEntry.