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. |
| Conjunto | 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 obtém todas as propriedades e métodos da Tarefa. |
Get-Task | Format-List |
Esse cmdlet exibe o resultado da consulta em uma lista formatada. Pode encaminhar a saída de qualquer cmdlet Get para Format-List para ver todo o conjunto de propriedades existentes no objeto devolvido por esse comando ou pode especificar propriedades individuais que pretende ver, separadas por vírgulas, como no exemplo seguinte: Get-Mailbox john | Format-List alias,*quota*. |
Help Task |
Este cmdlet obtém informações de ajuda da Shell de Gestão do Exchange para qualquer tarefa no Exchange 2013, como no exemplo seguinte: Help Get-Mailbox. |
Get-Task | Format-List > file.txt |
Este cmdlet exporta a saída da Tarefa para um ficheiro de texto: file.txt |
Permissões
| Comando | Descrição |
|---|---|
Get-RoleGroupMember "Organization Management" |
Este comando obtém os membros do grupo de funções gestão da Gestão da 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, é criado um novo grupo de funções denominado Administradores de Seattle e são atribuídas as funções Destinatários de Correio, Criação de Destinatários de Correio e Exportação de Importação da Caixa de Correio . 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 |
Estes comandos abrem uma nova sessão remota da Shell entre um computador associado a um 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 |
Estes comandos abrem uma nova sessão remota da Shell entre um computador associado a um 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 ficheiro para um servidor remoto do Exchange 2013 com o parâmetro FileData num 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 ficheiro no seu computador local através desta 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 ficheiro 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. |