Get-ManagementRole

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-ManagementRole para ver las funciones de administración creadas en su organización.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]
Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-Recurse]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]
Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Cmdlet <String>]
   [-CmdletParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]
Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Script <String>]
   [-ScriptParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Description

Puede ver las funciones de administración de distintos modos, desde enumerar todas las funciones de la organización hasta enumerar sólo las funciones secundarias de una función principal específica. También puede ver los detalles de una función específica canalizando el resultado del cmdlet Get-ManagementRole al cmdlet Format-List.

Para obtener más información acerca de las funciones de administración, consulte Descripción de los roles de administración.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-ManagementRole

En este ejemplo se enumera todas las funciones que se han creado en su organización.

Ejemplo 2

Get-ManagementRole "Mail Recipients" -Recurse

En este ejemplo se enumera todas las funciones que son elementos secundarios de la función de administración de destinatarios de correo. El comando realiza una consulta recursiva de todas las funciones secundarias de la función principal especificada. Esta consulta recursiva busca todas las funciones secundarias, desde los elementos secundarios inmediatos del elemento principal hasta la última función secundaria de la jerarquía. En una lista recursiva, la función principal también se incluye en la lista.

Ejemplo 3

Get-ManagementRole -CmdletParameters Identity, Database

En este ejemplo se enumera todas las funciones que contienen los parámetros Identity y Database. No se devuelven las funciones que contienen únicamente uno de los parámetros.

Ejemplo 4

Get-ManagementRole -RoleType UnScopedTopLevel

En este ejemplo se enumeran todos los roles que tienen un tipo de UnScopedTopLevel. Estos roles contienen scripts personalizados o cmdlets que no son de Exchange.

Ejemplo 5

Get-ManagementRole "Transport Rules" | Format-List Name, RoleType

En este ejemplo se recupera sólo la función Reglas de transporte y transfiere el resultado del cmdlet Get-ManagementRole al cmdlet Format-List. A continuación, el cmdlet Format-List muestra sólo las propiedades Name y RoleType de la función Reglas de transporte. Para obtener más información acerca de la canalización y el cmdlet Format-List, consulte About pipelines y Working with Command Output.

Ejemplo 6

Get-ManagementRole "Mail Recipients" -GetChildren

En este ejemplo se enumera los elementos secundarios inmediatos de la función de destinatarios de correo. Sólo se devuelven las funciones que tienen la función de destinatarios de correo como función principal. La función de destinatarios de correo no se devuelve en la lista.

Parámetros

-Cmdlet

El parámetro Cmdlet devuelve una lista de todas las funciones que incluyen el cmdlet especificado.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-CmdletParameters

El parámetro CmdletParameters devuelve una lista de todos los roles que incluyen el parámetro o los parámetros especificados. Puede especificar más de un parámetro si separa cada uno con una coma. Si especifica varios parámetros, sólo se devuelven los roles que incluyen todos los parámetros especificados.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-GetChildren

El parámetro GetChildren recupera una lista de todos los roles que se crearon de acuerdo con el rol primario en el parámetro Identity. Se incluyen sólo las funciones secundarias inmediatas de la función principal. El parámetro GetChildren sólo se puede usar con los parámetros Identity y RoleType.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-Identity

El parámetro Identity especifica el rol que quiere ver. Si la función que desea ver contiene espacios, incluya el nombre entre comillas ("). Puede usar el carácter comodín ( * ) y un nombre de función parcial para coincidir con varios roles.

Type:RoleIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-Recurse

El parámetro Recurse recupera una lista de todos los roles que se crearon de acuerdo con el rol primario en el parámetro Identity. Se devuelven la función especificada en el parámetro Identity, sus funciones secundarias y sus elementos secundarios. El parámetro Recurse sólo se puede usar con los parámetros Identity y RoleType.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-RoleType

El parámetro RoleType devuelve una lista de las funciones que coinciden con el tipo de función especificado. Para obtener una lista de los tipos de roles válidos, consulte Understanding Management roles.

Type:RoleType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-Script

El parámetro Script devuelve una lista de todas las funciones que incluyen la secuencia de comandos especificada.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-ScriptParameters

El parámetro ScriptParameters devuelve una lista de todos los roles que incluyen el parámetro o los parámetros especificados. Puede especificar más de un parámetro si separa cada uno con una coma. Si especifica varios parámetros, sólo se devuelven los roles que incluyen todos los parámetros especificados.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection

Entradas

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.