Cambiar una entrada de función
Se aplica a: Exchange Server 2013
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 2013, consulte Descripción de los roles de administración.
No se pueden modificar las entradas de función en funciones integradas de administració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 un rol.
Advertencia
Para agregar o quitar parámetros de una entrada de rol, 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 rol los parámetros que especifique mediante el parámetro 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 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.
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.
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.
Usar el Shell para agregar uno o más parámetros a una entrada de función
Para agregar parámetros a una entrada de rol, debe especificar los parámetros que desea agregar mediante el parámetro Parameters . A continuación, 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 el rol 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
Para quitar parámetros de una entrada de rol, debe especificar los parámetros que desea quitar mediante el parámetro Parameters . A continuación, 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 el rol Administradores del servidor 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
Para quitar todos los parámetros de una entrada de rol, 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 el rol de administradores de destinatarios.
Set-ManagementRoleEntry "Recipient Administrators\Set-CASMailbox" -Parameters $Null
Para obtener información detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.
Usar el Shell para aplicar un conjunto específico de parámetros
Si solo desea incluir un conjunto específico de parámetros en una entrada de rol, especifique solo el parámetro Parameters . No incluya los parámetros AddParameter o RemoveParameter . Cuando se especifica solo el parámetro Parameters , solo se incluyen los parámetros especificados en el comando en la entrada de rol. 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 solo se incluyen los parámetros Identity, DisplayName, MissedCallNotificationEnabled y PersonalAuthAttendantEnabled en el cmdlet Set-UMMailbox del rol Destinatarios de correo 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.