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-ManagementRoleEn este ejemplo se enumera todas las funciones que se han creado en su organización.
Ejemplo 2
Get-ManagementRole "Mail Recipients" -RecurseEn 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, DatabaseEn 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 UnScopedTopLevelEn 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, RoleTypeEn 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 sobre la canalización y el cmdlet Format-List, vea Acerca de las canalizaciones y Trabajo con la salida del comando.
Ejemplo 6
Get-ManagementRole "Mail Recipients" -GetChildrenEn 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 |
| Required: | False |
| 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, 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 |
| Required: | False |
| 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, 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 |
| Required: | False |
| 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. No es necesario especificar un valor con este modificador.
En los resultados solo se incluyen los roles secundarios inmediatos del rol primario.
Este modificador solo se puede usar con los parámetros Identity y RoleType.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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, 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 de comodín (*) y un nombre de función parcial para buscar varias funciones.
| Type: | RoleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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, 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. No es necesario especificar un valor con este modificador.
Se devuelven la función especificada en el parámetro Identity, sus funciones secundarias y sus elementos secundarios.
Este modificador solo se puede usar con los parámetros Identity y RoleType.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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, 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 tipos de roles válidos, consulte Descripción de los roles de administración.
| Type: | RoleType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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, 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 |
| Required: | False |
| 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, 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 |
| Required: | False |
| 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, Exchange Online Protection |
Entradas
Input types
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
Output types
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.