Agregar una entrada de función a una función de nivel superior sin ámbito
Se aplica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3
Última modificación del tema: 2012-07-23
Puede agregar scripts y cmdlets que no son de Exchange a funciones de administración de nivel superior sin ámbito si desea que nuevos scripts o cmdlets que no son de Exchange estén disponibles para las funciones sin ámbito existentes. Estos scripts y cmdlets que no son de Exchange se agregan como entradas de función de administración a las funciones de administración de nivel superior sin ámbito. De esa manera, esas entradas de función de nivel superior sin ámbito o cualquier función sin ámbito derivada de funciones de nivel superior pueden usarlos. Para obtener más información acerca de las entradas de funciones sin ámbito, consulte Descripción de las funciones de administración.
Nota
Si desea cambiar una entrada de función en una función de administración que contenga cmdlets de Exchange, consulte Cambiar una entrada de función.
¿Está buscando otras tareas de administración relacionadas con funciones? Consulte Administración de permisos avanzados.
Requisitos previos
La capacidad de agregar una entrada de función en una función de nivel superior sin ámbito no se incluye en ningún grupo de función de administración de manera predeterminada. Para que el usuario pueda agregar una entrada de función de nivel superior sin ámbito, debe asignar primero la función Administración de funciones sin ámbito a un usuario o a un grupo de seguridad universal (USG) o un grupo de función del cual el usuario es miembro. Para obtener más información acerca de la adición de una función a un grupo de funciones, un usuario o un grupo de seguridad universal, consulte los siguientes temas:
Agregar una entrada de función de script a una función de nivel superior sin ámbito
Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Si desea agregar un script a una función sin ámbito existente, use este procedimiento. Si desea agregar un cmdlet que no es de Exchange a una función sin ámbito existente, consulte "Agregar una entrada de función de cmdlet que no es de Exchange a una función de nivel superior sin ámbito" más adelante en este tema.
Para agregar un script de Windows PowerShell a una función de nivel superior sin ámbito, debe agregar una entrada de función de administración a la función. La entrada de función contiene el nombre del script y los parámetros que desea poner a disposición en la función.
El script debe residir en el directorio de scripts en la ruta de instalación de Microsoft Exchange Server 2010 en todos los servidores que ejecuten Exchange 2010 en los cuales los usuarios puedan conectarse para ejecutar el script. Si un usuario tiene acceso para ejecutar un script, pero el script no se encuentra en el servidor de Exchange 2010 al cual se conecta el usuario, se produce un error. De manera predeterminada, la ruta al directorio de scripts es C:\Archivos de programa\Microsoft\Exchange Server\V14\Scripts.
Después de que copia el script en los servidores de Exchange 2010 adecuados y decide cuáles parámetros de script se deben usar, cree la entrada de función mediante la siguiente sintaxis.
Add-ManagementRoleEntry <unscoped top-level role name>\<script filename> -Parameters <parameter 1, parameter 2, parameter...> -Type Script -UnscopedTopLevel
En este ejemplo, se agrega el script BulkProvisionUsers.ps1 a la función scripts de TI con los parámetros Name y Location.
Add-ManagementRoleEntry "IT Scripts\BulkProvisionUsers.ps1" -Parameters Name, Location -Type Script -UnscopedTopLevel
Nota
El cmdlet Add-ManagementRoleEntry realiza la validación básica para asegurarse de que agregue solamente los parámetros que existen en el script. No obstante, no se realiza otra validación después de que se agrega la entrada de función. Si los parámetros se agregan o quitan después, debe actualizar manualmente las entradas de función que contienen el script.
Agregar una entrada de función de cmdlet que no es de Exchange a una función de nivel superior sin ámbito
Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el Entrada "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Si desea agregar un cmdlet que no es de Exchange a una función sin ámbito existente, use este procedimiento. Si desea agregar un cmdlet de script a una función sin ámbito existente, consulte "Agregar una entrada de función de script a una función de nivel superior sin ámbito" más adelante en este tema.
Para agregar cmdlet que no es Exchange a una función de nivel superior sin ámbito, debe agregar una entrada de función de administración a la función. La entrada de función contiene el complemento de cmdlet, el nombre del cmdlet y los parámetros del cmdlet que desea poner a disposición en la función.
Si agrega cmdlets que no son Exchange a la nueva función, los cmdlets se deben instalar en todos los servidores de Exchange 2010 en los cuales los usuarios puedan conectarse para ejecutar los cmdlets. Para saber cómo instalar y registrar correctamente los complementos de Windows PowerShell que contienen los cmdlets que desea usar, consulte la documentación para su producto.
Después de instalar el componente PowerShell de Windows que contiene los cmdlet adecuados en los servidores de Exchange 2010 y de decidir qué parámetros de cmdlet se deben usar, cree la entrada de función con la siguiente sintaxis.
Add-ManagementRoleEntry <unscoped top-level role name>\<cmdlet name> -PSSnapinName <snap-in name> -Parameters <parameter 1, parameter 2, parameter...> -Type Cmdlet -UnscopedTopLevel
En este ejemplo, se agrega el cmdlet Set-WidgetConfiguration en el complemento Contoso.Admin.Cmdlets para la función de cmdlets de Widget con los parámetros Database y Size.
Add-ManagementRoleEntry "Widget Cmdlets\Set-WidgetConfiguration" -PSSnapinName Contoso.Admin.Cmdlets -Parameters Database, Size -Type Cmdlet -UnscopedTopLevel
Nota
El cmdlet Add-ManagementRoleEntry realiza la validación básica para asegurarse de que agregue solamente los parámetros que existen en el cmdlet. No obstante, no se realiza otra validación después de que se agrega la entrada de función. Si el cmdlet se cambia más adelante y se agregan o quitan parámetros, debe actualizar manualmente las entradas de función que contienen el cmdlet.
Otras tareas
Después de agregar una entrada de función o una función de nivel superior sin ámbito, es posible que también desee realizar las siguientes tareas:
© 2010 Microsoft Corporation. Reservados todos los derechos.