Referência rápida do Shell de Gerenciamento do Exchange para o Exchange 2013
Aplica-se a: Exchange Server 2013
Este tópico descreve os cmdlets utilizados mais frequentemente disponíveis na versão Release to Manufacturing (RTM) e posteriores do Microsoft Exchange Server 2013 e fornece exemplos para seu uso.
Observação
Mais conteúdo será adicionado sobre outras áreas de Exchange 2013, em breve.
Para obter mais informações sobre o shell de Gerenciamento do Exchangeno Exchange 2013 e todos os cmdlets disponíveis, consulte os seguintes tópicos:
O que deseja saber?
Ações de cmdlet comuns
Os seguintes verbos são suportados pela maioria dos cmdlets e são associados a uma ação específica.
| Verbo | Descrição |
|---|---|
| Novo | O verbo New cria uma nova instância de algo, como uma definição de configuração nova, um banco de dados novo ou um conector SMTP novo. |
| Remove | O verbo Remove remove uma instância de algo, como uma caixa de correio ou regras de transporte. Todos os cmdlets Remove oferecem suporte aos parâmetros WhatIf e Confirm. Para obter mais informações sobre esses parâmetros, consulte Important Parameters. |
| Habilitar | O verbo Enable habilita uma configuração ou habilita mensagens em um destinatário. |
| Disable | O verbo Disable desabilita uma configuração habilitada ou desabilita mensagens em um destinatário. Todas as tarefas Disable também oferecem suporte aos parâmetros WhatIf e Confirm. Para obter mais informações sobre esses parâmetros, consulte Important Parameters. |
| Set | O verbo Set modifica parâmetros específicos de um objeto, como o alias de um contato ou a retenção de itens excluídos de um banco de dados de caixa de correio. |
| Get | O verbo Get consulta um objeto específico ou um subconjunto de um tipo de objeto, como uma caixa de correio específica, todos os usuários de caixa de correio ou usuários de caixa de correio em um domínio. |
Parâmetros importantes
Os seguintes parâmetros ajudam a controlar como seus comandos são executados e indicam exatamente o que um comando fará antes de afetar dados.
| Parâmetro | Descrição |
|---|---|
| Identidade | O parâmetro Identity identifica o único objeto da tarefa. Normalmente é usado com os cmdlets Enable, Disable, Remove, Set, e Get. Identity também é um parâmetro posicional, o que significa que não é preciso especificar Identity quando especificar o valor do parâmetro na linha de comando. Por exemplo, Get-Mailbox -Identity user1 consulta a caixa de correio de user1. Get-Mailbox user1 é equivalente a Get-Mailbox -Identity user1. |
| Whatif | O parâmetro WhatIf instrui o cmdlet a simular as ações que ele executará no objeto. Usando o parâmetro WhatIf, pode-se visualizar quais alterações ocorreriam sem realmente aplicar as alterações. O valor padrão é $true. |
| Confirmar | O parâmetro Confirm faz com que o cmdlet pause o processamento e exige que o administrador confirme o que o cmdlet fará antes que o processamento continue. O valor padrão é $true. |
| Validar | O parâmetro Validate faz com que o cmdlet verifique se todos os pré-requisitos para executar a operação são atendidos e se a operação será concluída com êxito. |
Dicas e truques
Os seguintes comandos são associados com diversas tarefas que se pode utilizar ao administrar o Exchange 2013.
| Cmdlet | Descrição |
|---|---|
Get-Command |
Esse cmdlet recupera todas as tarefas que podem ser executadas no Exchange 2013. |
Get-Command *keyword* |
Esse cmdlet recupera tarefas que têm palavra-chave no cmdlet. |
Get-Task | Get-Member |
Este cmdlet recupera todas as propriedades e métodos da Tarefa. |
Get-Task | Format-List |
Esse cmdlet exibe o resultado da consulta em uma lista formatada. Você pode canalizar a saída de qualquer cmdlet Get para Format-List para exibir todo o conjunto de propriedades que existem no objeto retornado por esse comando ou especificar propriedades individuais que deseja exibir, separadas por vírgulas, como no exemplo a seguir: Get-Mailbox john | Format-List alias,*quota*. |
Help Task |
Este cmdlet recupera informações de ajuda do Shell de Gerenciamento do Exchange para qualquer tarefa no Exchange 2013, como no exemplo a seguir: Help Get-Mailbox. |
Get-Task | Format-List > file.txt |
Este cmdlet exporta a saída da Tarefa para um arquivo de texto: file.txt |
Permissões
| Comando | Descrição |
|---|---|
Get-RoleGroupMember "Organization Management" |
Esse comando recupera os membros do grupo de funções de gerenciamento de gerenciamento de organização . |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers |
Este comando recupera uma lista de todos os usuários que têm permissões fornecidas pela função de gerenciamento Criação de Destinatário de Email. Isso inclui usuários que são membros de grupos de função ou grupos de segurança universal (USGs) que têm a função de Criação de Destinatário de Email. Isso não inclui usuários que são membros de grupos de função vinculados em outra floresta. |
Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry |
Este comando recupera uma lista de cmdlets que o usuário Administrador pode executar. |
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} |
Este comando recupera uma lista de todos os usuários que podem executar o cmdlet Remove-Mailbox. |
Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain |
Este comando recupera uma lista de todos os usuários que podem modificar a caixa de correio 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 cria uma novo escopo de gerenciamento e grupo de funções de gerenciamento para habilitar membros do grupo de funções para gerenciar destinatários em Seattle. Primeiro, o escopo de gerenciamento Usuários de Seattle é criado, que corresponde somente a destinatários que têm o atributo Seattle na Cidade em seus objetos de usuário. Em seguida, um novo grupo de funções chamado Administradores de Seattle é criado e as funções Destinatários de Email, Criação de Destinatário de Email e Exportação de Importação de Caixa de Correio são atribuídas. O grupo de funções é estendido de forma que seus membros possam gerenciar somente usuários que correspondam ao escopo de filtro de destinatário Usuários 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 cria um novo escopo de gerenciamento e copia um grupo de gerenciamento existente para habilitar os membros do novo grupo de funções para gerenciar somente servidores no site Active Directory Vancouver. Primeiro, o escopo de gerenciamento Servidores de Vancouver é criado, o qual corresponde somente a servidores localizados no site do Active Directory Vancouver. O site Active Directory está armazenado no atributo ServerSite nos objetos do servidor. Então, um novo grupo de funções chamado Gerenciamento de Servidor Vancouver é criado que é uma cópia do grupo de funções Gerenciamento do Servidor. Este novo grupo de funções, entretanto, é estendido para permitir de todos os seus membros gerenciem somente servidores que correspondam ao filtro de configuraçãoServidores de Vancouver. |
Add-RoleGroupMember "Organization Management" -Member davids |
Este comando adiciona o usuário davids ao grupo de funções Gerenciamento de Organização. |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" | Remove-ManagementRoleAssignment |
Este comando remove a função Criação de Destinatário de Email do grupo de funções Seattle Admins. Este comando é útil porque não é necessário saber o nome da atribuição de função de gerenciamento que atribui a função ao grupo de funções. |
Shell Remota
| Comando | Descrição |
|---|---|
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos Import-PSSession $Session |
Esses comandos abrem uma nova sessão remota do Shell entre um computador ingressado no domínio local e um servidor remoto do Exchange 2013 com o FQDN ExServer.contoso.com. Utilize esse comando se desejar administrar um servidor Exchange 2013 remoto e somente ter o Windows Management Framework, que inclui a interface de linha de comando Windows PowerShell, instalada em seu computador local. Esse comando utiliza suas credenciais de login atuais para autenticar contra o servidor Exchange 2013 remoto. |
$UserCredential = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential Import-PSSession $Session |
Esses comandos abrem uma nova sessão remota do Shell entre um computador ingressado no domínio local e um servidor remoto do Exchange 2013 com o FQDN ExServer.contoso.com. Utilize esse comando se desejar adminstrar um servidor Exchange 2013 remoto e somente ter o Windows Management Framework, que inclui a interface de linha de comando Windows PowerShell, instalada em seu computador local. Esse comando utiliza suas credenciais de login atuais para autenticar contra o servidor Exchange 2013 remoto. |
Remove-PSSession $Session |
Esse comando fecha a sessão shell remota entre um computador local e o servidor Exchange 2013 remoto. |
Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([System.IO.File]::ReadAllBytes('M:\AudioFiles\TonySmith.wma')) |
Este comando mostra um exemplo da sintaxe necessária para importar um arquivo para um servidor remoto do Exchange 2013 usando o parâmetro FileData em um cmdlet. A sintaxe encapsula os dados contidos no arquivo M:\AudioFiles\TonySmith.wma e flui os dados para a propriedade FileData no cmdlet Import-RecipientDataProperty. O parâmetro FileData aceita dados de um arquivo em seu computador local usando essa sintaxe na maioria dos cmdlets. |
$SN = Export-RecipientDataProperty -Identity tonys@contoso.com -SpokenName |
Este comando mostra um exemplo da sintaxe necessária para exportar um arquivo de um servidor remoto do Exchange 2013. A sintaxe encapsula os dados armazenados na propriedade FileData no objeto retornado pelo cmdlet, e então, flui os dados ao computador local. Em seguida, os dados são armazenados no arquivo C:\tonysmith.wma file. A maioria dos cmdlets que tem como saída objetos com uma propriedade FileData utiliza essa sintaxe para exportar dados para um arquivo no computador local. |