Cambiar una entrada de función en una función de nivel superior sin ámbito
Se aplica a: Exchange Server 2013
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 los roles 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 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.
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:
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 función de nivel superior sin ámbito, debe realizar las siguientes acciones:
Especifique los parámetros que desea agregar mediante el parámetro Parameters .
Especifique el parámetro AddParameter para indicar que desea realizar una operación de adición.
Especifique el parámetro UnscopedTopLevel para indicar que va a cambiar una entrada de rol en un rol 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 deCreateUsers.ps1 en el rol 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
Para quitar parámetros de una entrada de función, debe realizar las siguientes acciones:
Especifique los parámetros que desea quitar mediante 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 va a cambiar una entrada de rol en un rol 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 de Exchange en el rol Administradores del servidor 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
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 va a cambiar una entrada de rol en un rol 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 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 desea que se incluya solamente un conjunto de parámetros específico en una entrada de función, debe realizar las siguientes acciones:
Especifique solo el parámetro Parameters . No incluya los parámetros AddParameter o RemoveParameter .
Especifique el parámetro UnscopedTopLevel para indicar que va a cambiar una entrada de rol en un rol 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 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>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -UnscopedTopLevel
En este ejemplo solo se incluyen los parámetros Alias, DisplayName, WidgetConfig y Enabled en el cmdlet Set-Widget del rol 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:
Agregar una entrada de función a una función
Administrar miembros de grupos de roles
Agregar una función a un usuario o grupo de seguridad universal
Quitar una función de un usuario o un grupo de seguridad universal