Guía de referencia rápida del Shell de administración de Exchange para Exchange 2013

Artículo
04/04/2023

Se aplica a: Exchange Server 2013

Este tema describe los cmdlets que se usan con más frecuencia en las versiones RTM y posteriores de Microsoft Exchange Server 2013 y se ofrecen ejemplos de uso.

Nota:

Próximamente se añadirá más contenido sobre otras áreas de Exchange 2013.

Para obtener más información acerca del Shell de administración de Exchange en Exchange 2013y de los cmdlets disponibles, consulte los temas siguientes:

¿Sobre qué desea obtener información?

Acciones de cmdlet comunes

Los verbos siguientes son admitidos por la mayor parte de los cmdlets y están asociados a una acción específica.

Verbo	Descripción
Nuevo	El verbo New crea una instancia de algo como, por ejemplo, una configuración nueva, una base de datos nueva o un conector SMTP nuevo.
Remove	El verbo Remove quita una instancia de algo como, por ejemplo, un buzón o una regla de transporte. Todos los cmdlets Remove admiten los parámetros WhatIf y Confirm. Para obtener más información acerca de estos parámetros, consulte Important Parameters.
Habilitación	El verbo Enable habilita una configuración o el correo de un destinatario.
Disable	El verbo Disable deshabilita una configuración habilitada o deshabilita el correo de un destinatario. Todas las tareas Disable admiten los parámetros WhatIf y Confirm. Para obtener más información acerca de estos parámetros, consulte Important Parameters.
Set	El verbo Set modifica la configuración específica de un objeto como, por ejemplo, el alias de un contacto o la retención de un elemento eliminado de una base de datos de buzones.
Get	El verbo Get consulta un objeto específico o un subconjunto de un tipo de objetos como, por ejemplo, un buzón específico, los usuarios de todos los buzones o los usuarios de buzones de un dominio.

Parámetros importantes

Los parámetros siguientes ayudan a controlar cómo se ejecutan los comandos e indican exactamente qué hará un comando antes de que afecte a los datos.

Parámetro	Descripción
Identidad	El parámetro Identity identifica el objeto único de la tarea. Se usa normalmente con los cmdlets Enable, Disable, Remove, Set y Get. Identity es también un parámetro de posición, lo cual significa que no tiene que especificar Identity al indicar el valor del parámetro en la línea de comandos. Por ejemplo, Get-Mailbox -Identity usuario1 consulta el buzón de usuario1. Get-Mailbox user1 es equivalente a `Get-Mailbox -Identity user1`.
WhatIf	El parámetro WhatIf indica al cmdlet que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos realmente. El valor predeterminado es $true.
Confirmar	El parámetro Confirm hace que el cmdlet ponga en pausa el procesamiento y requiere que el administrador reconozca qué hará el cmdlet antes de seguir con el procesamiento. El valor predeterminado es $true.
Validar	El parámetro Validate hace que el cmdlet compruebe que se cumplen todos los requisitos para ejecutar la operación y garantizar que ésta finalice correctamente.

Sugerencias y trucos

Los comandos siguientes están asociados con varias tareas que puede usar para la administración de Exchange 2013.

Cmdlet	Descripción
`Get-Command`	Este cmdlet recupera todas las tareas que se pueden ejecutar en Exchange 2013.
`Get-Command keyword`	Este cmdlet recupera las tareas que tienen palabra clave en el cmdlet.
`Get-Task \| Get-Member`	Este cmdlet recupera todas las propiedades y métodos de Task.
`Get-Task \| Format-List`	Este cmdlet muestra el resultado de la consulta en una lista de formato. Puede canalizar la salida de cualquier cmdlet Get a Format-List para ver todo el conjunto de propiedades que existen en el objeto devuelto por ese comando, o bien puede especificar propiedades individuales que desea ver, separadas por comas, como en el ejemplo siguiente: `Get-Mailbox john \| Format-List alias,quota`.
`Help Task`	Este cmdlet recupera información de ayuda del Shell de administración de Exchange para cualquier tarea de Exchange 2013, como en el ejemplo siguiente: `Help Get-Mailbox`.
`Get-Task \| Format-List > file.txt`	Este cmdlet exporta la salida de Task a un archivo de texto: file.txt

Permisos

Comando	Descripción
`Get-RoleGroupMember "Organization Management"`	Este comando recupera los miembros del grupo de roles de administración de administración de la organización .
`Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers`	Este ejemplo muestra una lista de todos los usuarios a los que el rol de administración Creación de destinatarios de correo ha concedido permiso. Esto incluye usuarios que pertenecen a grupos de roles o grupos de seguridad universales (USG) que tienen el rol Creación de destinatarios de correo. No se incluye a los usuarios que pertenecen a grupos de roles vinculados en otro bosque.
`Get-ManagementRoleAssignment -RoleAssignee Administrator \| Get-ManagementRole \| Get-ManagementRoleEntry`	Este comando recupera una lista de cmdlets que el usuario Administrador puede ejecutar.
`ForEach ($RoleEntry in Get-ManagementRoleEntry *Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment -Role $RoleEntry.Role -GetEffectiveUsers -Delegating $False \| Where-Object {$_.EffectiveUserName -Ne "All Group Members"} \| FL Role, EffectiveUserName, AssignmentChain}`	En este ejemplo se recupera una lista de todos los usuarios que pueden ejecutar el cmdlet Remove-Mailbox.
`Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers \| FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain`	En este ejemplo se recupera una lista de todos los usuarios que pueden modificar el buzón de kima.
`New-ManagementScope "Seattle Users" -RecipientRestrictionFilter "City -Eq 'Seattle'"` `New-RoleGroup "Seattle Admins" -Roles "Mail Recipients", "Mail Recipient Creation", "Mailbox Import Export", -CustomRecipientWriteScope "Seattle Users"`	Este comando crea un nuevo ámbito de administración y grupo de roles de administración para permitir que los miembros del grupo de roles administren los destinatarios de Seattle. En primer lugar, se crea el ámbito de administración Usuarios de Seattle, que incluye solo a los destinatarios que tienen Seattle en el atributo Ciudad de su objeto de usuario. A continuación, se crea un nuevo grupo de roles denominado Administradores de Seattle y se asignan los roles Destinatarios de correo, Creación de destinatarios de correo y Exportación de importación de buzones . El grupo de roles se configura de modo que sus miembros solo puedan administrar los usuarios que coincidan con el ámbito del filtro de destinatarios Usuarios de Seattle.
`New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -Eq 'Vancouver'"` `$RoleGroup = Get-RoleGroup "Server Management" <br/><br/> New-RoleGroup "Vancouver Server Management" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Vancouver Servers"`	Este comando crea un nuevo ámbito de administración y copia un grupo de roles existente para permitir que los miembros del nuevo grupo de roles administre solo los servidores del sitio Active Directory Vancouver. En primer lugar, se crea el ámbito de administración Servidores de Vancouver, que incluye solo los servidores situados en el sitio Active Directory Vancouver. El sitio Active Directory se almacena en el atributo ServerSite en los objetos de servidor. A continuación se crea un nuevo grupo de roles llamado Administración de servidores de Vancouver, que es una copia del grupo de roles Administración de servidores. El nuevo grupo de roles se configura de modo que sus miembros solo puedan administrar los servidores que coincidan con el ámbito del filtro de configuración Servidores de Vancouver.
`Add-RoleGroupMember "Organization Management" -Member davids`	Este comando agrega el usuario davids al grupo de roles Administración de la organización.
`Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" \| Remove-ManagementRoleAssignment`	Este comando elimina el rol Creación de destinatarios de correo del grupo de roles Administradores de Seattle. Este comando es útil porque no es necesario saber el nombre de la asignación de roles de administración que asigna el rol al grupo de roles.

Shell remoto

Comando	Descripción
`$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos` `Import-PSSession $Session`	Estos comandos abren una nueva sesión remota de Shell entre un equipo local unido a un dominio y un servidor remoto de Exchange 2013 con el FQDN ExServer.contoso.com. Use este comando si desea administrar un servidor remoto de Exchange 2013 y solo desea tener Windows Management Framework, que incluye la interfaz de línea de comandos Windows PowerShell instalada en su equipo local. Este comando usa sus credenciales de inicio de sesión actuales para autenticar el servidor remoto de Exchange 2013.
`$UserCredential = Get-Credential` `$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential` `Import-PSSession $Session`	Estos comandos abren una nueva sesión remota de Shell entre un equipo local unido a un dominio y un servidor remoto de Exchange 2013 con el FQDN ExServer.contoso.com. Use este comando si desea administrar un servidor remoto de Exchange 2013 y solo desea tener Windows Management Framework, que incluye la interfaz de línea de comandos Windows PowerShell instalada en su equipo local. Este comando usa los credenciales que haya especificado para autenticar el servidor remoto de Exchange 2013.
`Remove-PSSession $Session`	Este comando cierra la sesión remota del Shell establecida entre un equipo local y el servidor remoto de Exchange 2013.
`Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([System.IO.File]::ReadAllBytes('M:\AudioFiles\TonySmith.wma'))`	Este comando muestra un ejemplo de la sintaxis necesaria para importar un archivo en un servidor remoto de Exchange 2013 mediante el parámetro FileData en un cmdlet. La sintaxis encapsula los datos que contiene el archivo M:\AudioFiles\TonySmith.wma y transmite los datos a la propiedad FileData en el cmdlet Import-RecipientDataProperty. El parámetro FileData acepta datos de un archivo en el equipo local mediante esta sintaxis en la mayoría de los cmdlets.
`$SN = Export-RecipientDataProperty -Identity tonys@contoso.com -SpokenName` `[System.IO.File]::WriteAllBytes('C:\tonysmith.wma', $SN.FileData)`	Este comando muestra un ejemplo de la sintaxis necesaria para exportar un archivo desde un servidor remoto de Exchange 2013. La sintaxis encapsula los datos almacenados en la propiedad FileData en el objeto que devuelve el cmdlet y transmite los datos al equipo local. A continuación, los datos se almacenan en el archivo C:\tonysmith.wma. La mayoría de cmdlets que devuelven objetos con una propiedad FileData usan esta sintaxis para exportar datos a un archivo del equipo local.