Cambiar una entrada de función en 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
Las entradas de función de administración en funciones de administración de nivel superior sin ámbito hacen referencia a los scripts y a los cmdlets que no son Exchange, los cuales se desea que estén disponibles para su asignación por función. Al cambiar los parámetros disponibles en una entrada de función, se controlan las acciones con el script o el cmdlet que no es Exchange de quienes tienen la función asignada. 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 cambiar una entrada de función en una función de nivel superior sin ámbito no se incluye en cualquier grupo de función de administración de manera predeterminada. Para que el usuario pueda agregar o cambiar 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 usuario, grupo de seguridad universal o grupo de funciones, consulte los siguientes temas:
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 "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Para agregar parámetros a una entrada de función de nivel superior sin ámbito, debe realizar las siguientes acciones:
Especifique los parámetros que desea agregar con el parámetro Parameters.
Especifique el parámetro AddParameter para indicar que desea realizar una operación de agregado.
Especifique el parámetro UnscopedTopLevel para indicar que está cambiando una entrada de función en una función de nivel superior sin ámbito. Si no especifica este parámetro al cambiar una entrada de función en una función sin ámbito, se produce un error.
Para agregar parámetros a una entrada de función, use la siguiente sintaxis.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -AddParameter -UnscopedTopLevel
En este ejemplo, se agregan los parámetros EmailAddress y City al script CreateUsers.ps1 en la función sin ámbito Administradores de destinatarios.
Set-ManagementRoleEntry "Recipient Administrators\CreateUsers.ps1" -Parameters EmailAddress, City -AddParameter -UnscopedTopLevel
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 "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Para quitar parámetros de una entrada de función, debe realizar las siguientes acciones:
Especifique los parámetros que desea quitar con el parámetro Parameters.
Especifique el parámetro RemoveParameter para indicar que desea realizar una operación de eliminación.
Especifique el parámetro UnscopedTopLevel para indicar que está cambiando una entrada de función en una función de nivel superior sin ámbito. Si no especifica este parámetro al cambiar una entrada de función en una función sin ámbito, se produce un error.
Advertencia
No puede deshacer las operaciones en las que se quitan elementos. Si, por error, quita un parámetro de una entrada de función, debe agregarlo nuevamente de forma manual.
Para quitar parámetros de una entrada de función, use la siguiente sintaxis.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -RemoveParameter -UnscopedTopLevel
En este ejemplo, se quitan los parámetros Delay, Force y Credential del cmdlet Start-Widget que no es Exchange en la función Administrador de servidores de nivel 1.
Set-ManagementRoleEntry "Tier 1 Server Administrators\Start-Widget" -Parameters Delay, Force, Credential -RemoveParameter -UnscopedTopLevel
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 "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Para quitar todos los parámetros de una entrada de función, debe realizar las siguientes acciones:
Especifique el valor
$Nullen el parámetro Parameters. No es necesario incluir el parámetro RemoveParameter.Especifique el parámetro UnscopedTopLevel para indicar que está cambiando una entrada de función en una función de nivel superior sin ámbito. Si no especifica este parámetro al cambiar una entrada de función en una función sin ámbito, se produce un error.
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 script o un cmdlet que no es Exchange y que todos los demás se excluyan.
Si no desea que la función tenga acceso a un script o un cmdlet que no es Exchange, 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>\<script or non-Exchange cmdlet> -Parameters $Null -UnscopedTopLevel
En este ejemplo, se quitan todos los parámetros del script FindMailboxesOverQuota.ps1 en la función Administradores de destinatarios.
Set-ManagementRoleEntry "Recipient Administrators\FindMailboxesOverQuota.ps1" -Parameters $Null -UnscopedTopLevel
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 "Funciones de administración que no son del ámbito" en el tema Permisos de administración de funciones.
Si desea que se incluya solamente un conjunto de parámetros específico en una entrada de función, debe realizar las siguientes acciones:
Especifique solamente el parámetro Parameters. No incluya los parámetros AddParameter ni RemoveParameter.
Especifique el parámetro UnscopedTopLevel para indicar que está cambiando una entrada de función en una función sin ámbito. Si no especifica este parámetro al cambiar una entrada de función en una función de nivel superior sin ámbito, se produce un error.
Advertencia
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>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -UnscopedTopLevel
En este ejemplo, se incluyen solo los parámetros Alias, DisplayName, WidgetConfig y Enabled en el cmdlet Set-Widget en la función Administradores de destinatarios de correo de Seattle.
Set-ManagementRoleEntry "Seattle Mail Recipient Admins\Set-UMMailbox" -Parameters Alias, DisplayName, WidgetConfig, Enabled -UnscopedTopLevel
Para obtener información más detallada acerca de la sintaxis y los parámetros, consulte Set-ManagementRoleEntry.
Otras tareas
Después de cambiar 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.