Get-ManagementRole
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser 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.
Sintaxis
GetChildren
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Recurse
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Identity
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Script
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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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 sobre la canalización y el cmdlet Format-List, consulte Acerca de las canalizaciones y Trabajo con la salida del comando.
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
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
El parámetro Cmdlet devuelve una lista de todas las funciones que incluyen el cmdlet especificado.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CmdletParameters
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades de parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-GetChildren
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetChildren
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | RoleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetChildren
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
Recurse
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
Identity
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
Script
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Recurse
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Recurse
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RoleType
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Propiedades de parámetro
| Tipo: | RoleType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Script
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
El parámetro Script devuelve una lista de todas las funciones que incluyen la secuencia de comandos especificada.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Script
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ScriptParameters
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Security & Compliance, Built-in security complemento para buzones locales
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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Script
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
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.