Краткий справочник по командной консоли Exchange для Exchange 2013Exchange Management Shell quick reference for Exchange 2013

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

В этом разделе описаны наиболее часто применяемые командлеты, доступные в окончательной первоначальной версии (RTM) и более поздних версиях Microsoft Exchange Server 2013, а также приведены примеры их использования.This topic describes the most frequently used cmdlets available in the release to manufacturing (RTM) and later versions of Microsoft Exchange Server 2013 and provides examples of their use.

Примечание

Скоро будет добавлено дополнительное содержимое о других аспектах использования Exchange 2013.More content will be added about other areas of Exchange 2013 soon.

Дополнительные сведения о командной консоли Exchange в Exchange 2013 и доступных командлетах см. в следующих разделах:For more information about the Exchange Management Shell in Exchange 2013 and all the available cmdlets, see the following topics:

О чем бы вы хотели узнать?What would you like to learn about?

Типовые действия командлетовCommon cmdlet actions

Следующие команды поддерживаются большинством командлетов и связаны с конкретным действием.The following verbs are supported by most cmdlets and are associated with a specific action.

СоздатьNew

Команда New создает новый экземпляр чего-либо, например новый параметр настройки, новую базу данных или новый соединитель SMTP.The New verb creates an instance of something, such as a new configuration setting, a new database, or a new SMTP connector.

УдалитьRemove

Команда Remove удаляет экземпляр чего-либо, например почтовый ящик или правило транспорта.The Remove verb removes an instance of something, such as a mailbox or transport rule.

Все командлеты Remove поддерживают параметры WhatIf и Confirm.All Remove cmdlets support the WhatIf and Confirm parameters. Дополнительные сведения об этих параметрах приведены в разделе Important Parameters.For more information about these parameters, see Important Parameters.

ЗадействоватьEnable

Команда Enable включает параметр или поддержку почты для получателя.The Enable verb enables a setting or mail-enables a recipient.

ЗапретитьDisable

Команда Disable отключает включенный параметр или поддержку почты для получателя.The Disable verb disables an enabled setting or mail-disables a recipient.

Все задачи Disable также обеспечивают поддержку параметров WhatIf и Confirm.All Disable tasks also support the WhatIf and Confirm parameters. Дополнительные сведения об этих параметрах приведены в разделе Important Parameters.For more information about these parameters, see Important Parameters.

SetSet

Команда Set изменяет конкретные параметры объекта, например псевдоним контакта или хранение удаленных элементов базы данных почтовых ящиков.The Set verb modifies specific settings of an object, such as the alias of a contact or the deleted item retention of a mailbox database.

GetGet

Команда Get запрашивает конкретный объект или подмножество типа объекта, таких как конкретный почтовый ящик, все пользователи почтовых ящиков или пользователей почтовых ящиков в домене.The Get verb queries a specific object or a subset of a type of object, such as a specific mailbox, all mailbox users, or mailbox users in a domain.

Важные параметрыImportant parameters

Нижеприведенные параметры помогают управлять выполнением команд и точно показывают, какие действия выполнит команда, прежде чем она повлияет на данные.The following parameters help you control how your commands run and indicate exactly what a command will do before it affects data.

УдостоверениеIdentity

Параметр Identity определяет уникальный объект для задачи. Он обычно используется с командлетами Enable, Disable, Remove, Set и Get. Параметр Identity также является позиционным — это значит, что необязательно указывать имя Identity, указывая значение данного параметра в командной строке.The Identity parameter identifies the unique object for the task. It's typically used with Enable, Disable, Remove, Set, and Get cmdlets. Identity is also a positional parameter, which means that you don't have to specify Identity when you specify the parameter's value on the command line.

Допустим, Get-Mailbox -Identity user1 запрашивает почтовый ящик пользователя user1. Командлет Get-Mailbox user1 эквивалентен командлету Get-Mailbox -Identity user1.For example, Get-Mailbox -Identity user1 queries for the mailbox of user1. Get-Mailbox user1 is equivalent to Get-Mailbox -Identity user1.

WhatIfWhatIf

Параметр WhatIf указывает командлету на необходимость имитировать действия, которые будут выполняться над объектом. С помощью параметра WhatIf можно просмотреть возможные изменения без реального применения любого из этих изменений. По умолчанию установлено значение $true.The WhatIf parameter instructs the cmdlet to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without actually applying any of the changes. The default value is $true.

ConfirmConfirm

Параметр Confirm используется для приостановки выполнения обработки командлетом и для ее продолжения требует подтверждения администратором дальнейших действий командлета. По умолчанию установлено значение $true.The Confirm parameter causes the cmdlet to pause processing and requires the administrator to acknowledge what the cmdlet will do before processing continues. The default value is $true.

ПроверкаValidate

Параметр Validate заставляет командлет проверить, что все требования, необходимые для выполнения операции, выполняются и что операция закончится успешно.The Validate parameter causes the cmdlet to check that all prerequisites for running the operation are satisfied and that the operation will complete successfully.

Советы и рекомендацииTips and tricks

Следующие команды связаны с различными задачами администрирования Exchange 2013.The following commands are associated with various tasks that you can use when administering Exchange 2013.

Get-CommandGet-Command

Этот командлет возвращает все задачи, которые могут быть выполнены в Exchange 2013.This cmdlet retrieves all tasks that can be executed in Exchange 2013.

Get – Command *ключевое слово*Get-Command *keyword*

Этот командлет возвращает задачи, в командлете которых содержится ключевое_слово.This cmdlet retrieves tasks that have keyword in the cmdlet.

Get-задача | Get-MemberGet-task | Get-Member

Этот командлет возвращает все свойства и методы задачи задача.This cmdlet retrieves all properties and methods of task.

Get-задача | Format-ListGet-task | Format-List

Этот командлет отображает выходные данные запроса в форматированном списке.This cmdlet displays the output of the query in a formatted list. Чтобы просмотреть весь набор свойств, существующих для объекта, возвращаемого этой командой, можно передать результат выполнения командлета Get в List, а также указать отдельные свойства, разделенные запятыми, как показано в примере ниже. : Get/Mailbox *John* | Format — псевдоним списка, \* квотаYou can pipe the output of any Get cmdlet to Format-List to view the whole set of properties that exist on the object returned by that command, or you can specify individual properties that you want to view, separated by commas, as in the following example: Get-Mailbox *john* | Format-List alias,\*quota

Help задачаHelp task

Этот командлет извлекает справочные сведения о командной консоли Exchange для любой задачи в Exchange 2013, как показано в следующем примере: Help Get/MailboxThis cmdlet retrieves Exchange Management Shell help information for any task in Exchange 2013, as in the following example: Help Get-Mailbox

Get –Task | Format — List > File. txtGet-task | Format-List > file.txt

Этот командлет выводит результат задачи задача в текстовый файл: file.txtThis cmdlet exports the output of task to a text file: file.txt

РазрешенияPermissions

Get – RoleGroupMember " Организация управления"Get-RoleGroupMember "Organization Management"

Эта команда получает список членов группы ролей "Управление организацией ".This command retrieves the members of the Organization Management management role group.

Get – ManagementRoleAssignment — роль " Создание " получателя почты — GetEffectiveUsersGet-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers

Эта команда извлекает список пользователей, которым предоставлены разрешения роли управления Mail Recipient Creation. Сюда относятся пользователи, входящие в группы ролей или универсальные группы безопасности, которым назначена эта роль. Сюда не входят пользователи, входящие в связанные группы ролей из другого леса.This command retrieves a list of all the users who are granted permissions provided by the Mail Recipient Creation management role. This includes users who are members of role groups or universal security groups (USGs) that are assigned the Mail Recipient Creation role. This doesn't include users who are members of linked role groups in another forest.

Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntryGet-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry

Эта команда извлекает список командлетов, которые может запускать пользователь Administrator.This command retrieves a list of cmdlets that the user Administrator can run.

ForEach ($RoleEntry в Get-ManagementRoleEntry \* \Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment-Role $RoleEntry. Role-GetEffectiveUsers-делегируing $false | Where – Object {$ _. EffectiveUserName — Ne "ALL Members"Group} | Роль FL, EffectiveUserName, Ассигнментчаин}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}

Эта команда извлекает список пользователей, которые могут запускать командлет Remove-Mailbox.This command retrieves a list of all the users who can run the Remove-Mailbox cmdlet.

Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChainGet-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain

Эта команда извлекает список пользователей, которые могут изменять почтовый ящик kima.This command retrieves a list of all users who can modify the mailbox of kima.

New — ManagementScope " Seattle Users " — RecipientRestrictionFilter { City – "EQ, Сиэтл " }New-ManagementScope "Seattle Users" -RecipientRestrictionFilter { City -Eq "Seattle" }

New – RoleGroup " Seattle Admins " — роли " получателей"почты, " Создание"получателей почты, " Экспорт"импорта почтовых ящиков, " Пользователи в Сиэтле CustomRecipientWriteScope"New-RoleGroup "Seattle Admins" -Roles "Mail Recipients", "Mail Recipient Creation", "Mailbox Import Export", -CustomRecipientWriteScope "Seattle Users"

Эта команда создает новую область управления и группу ролей управления, чтобы позволить членам группы ролей управлять получателями в Сиэтле.This command creates a new management scope and management role group to enable members of the role group to manage recipients in Seattle.

Сначала создается область управления Seattle Users, в которую входят только те получатели, у которых в атрибуте City объекта-пользователя имеется значение Seattle.First, the Seattle Users management scope is created, which matches only recipients who have Seattle in the City attribute on their user object.

Затем создаются новые группы ролей "Администраторы Сиэтле" и " Получатели почты", " Создание получателей почты" и " Импорт импорта почтовых ящиков".Then, a new role group called Seattle Admins is created and the Mail Recipients, Mail Recipient Creation, and Mailbox Import Export roles are assigned. Группа ролей привязывается к области, поэтому ее члены смогут управлять только пользователями, попадающими в область фильтрации получателей Seattle Users.The role group is scoped so that its members can manage only users who match the Seattle Users recipient filter scope.

New — ManagementScope " Vancouver Servers " — ServerRestrictionFilter { ServerSite – "EQ Vancouver " }New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter { ServerSite -Eq "Vancouver" }

$RoleGroup = Get RoleGroup " Server Management"$RoleGroup = Get-RoleGroup "Server Management"

New — RoleGroup " Vancouver Server Management " — Roles $RoleGroup. Roles "— CustomConfigWriteScope Vancouver Servers"New-RoleGroup "Vancouver Server Management" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Vancouver Servers"

Эта команда создает новую область управления и копирует существующую группу ролей, чтобы позволить членам новой группы ролей управлять только серверами из сайта Active Directory в Ванкувере.This command creates a new management scope and copies an existing role group to enable members of the new role group to manage only servers in the Vancouver Active Directory site.

Сначала создается область управления Vancouver Servers, в которую входят только серверы, расположенные в сайте Active Directory Vancouver. Сайт Active Directory указывается в атрибуте ServerSite объектов-серверов.First, the Vancouver Servers management scope is created, which matches only servers that are located in the Vancouver Active Directory site. The Active Directory site is stored in the ServerSite attribute on the server objects.

Затем создается новая группа ролей Vancouver Server Management, представляющая собой копию группы ролей Server Management. Новая группа ролей привязывается к области, поэтому ее члены смогут управлять только серверами, попадающими в область фильтрации конфигурации Vancouver Servers.Then, a new role group called Vancouver Server Management is created that's a copy of the Server Management role group. This new role group, however, is scoped to allow its members to manage only servers that match the Vancouver Servers configuration filter scope.

Add – RoleGroupMember " Organization Management " — Davids участникаAdd-RoleGroupMember "Organization Management" -Member davids

Эта команда добавляет пользователя davids в группу ролей Organization Management.This command adds the user davids to the Organization Management role group.

Get – ManagementRoleAssignment — роль " Создание " получателя почты — " Администраторы ролеассигни Сиэтле " | Remove — ManagementRoleAssignmentGet-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" | Remove-ManagementRoleAssignment

Эта команда удаляет роль Mail Recipient Creation из группы ролей Seattle Admins. Эта команда полезна, поскольку в ней не требуется знать имя назначения роли управления, связывающего роль с группой ролей.This command removes the Mail Recipient Creation role from the Seattle Admins role group. This command is useful because you don't need to know the name of the management role assignment that assigns the role to the role group.

Удаленная командная консоль ExchangeRemote Shell

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos

Import-PSSession $SessionImport-PSSession $Session

Эти команды открывают новый сеанс удаленной оболочки между локальным компьютером, подключенным к домену, и удаленным сервером Exchange 2013 с полным доменным именем ExServer.contoso.com.These commands open a new remote Shell session between a local domain-joined computer and a remote Exchange 2013 server with the FQDN ExServer.contoso.com. Используйте эту команду при необходимости администрирования удаленного сервера Exchange 2013 в случае, если на локальном компьютере доступна только платформа Windows Management Framework, в которую входит интерфейс командной строки Windows PowerShell.Use this command if you want to administer a remote Exchange 2013 server and only have the Windows Management Framework, which includes the Windows PowerShell command-line interface, installed on your local computer. Эта команда использует для подключения к удаленному серверу Exchange 2013 учетные данные текущего сеанса в системе.This command uses your current logon credentials to authenticate against the remote Exchange 2013 server.

$UserCredential = Get-Credential$UserCredential = Get-Credential

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential

Import-PSSession $SessionImport-PSSession $Session

Эти команды открывают новый сеанс удаленной оболочки между локальным компьютером, подключенным к домену, и удаленным сервером Exchange 2013 с полным доменным именем ExServer.contoso.com.These commands open a new remote Shell session between a local domain-joined computer and a remote Exchange 2013 server with the FQDN ExServer.contoso.com. Используйте эту команду при необходимости администрирования удаленного сервера Exchange 2013 в случае, если на локальном компьютере доступна только платформа Windows Management Framework, в которую входит среда Windows PowerShell.Use this command if you want to administer a remote Exchange 2013 server and only have the Windows Management Framework, which includes Windows PowerShell, installed on your local computer. Эта команда использует для подключения к удаленному серверу Exchange 2013 явно указываемые учетные данные.This command uses credentials you specify explicitly to authenticate against the remote Exchange 2013 server.

Remove-PSSession $SessionRemove-PSSession $Session

Эта команда закрывает удаленный сеанс консоли между локальным компьютером и удаленным сервером Exchange 2013.This command closes the remote Shell session between a local computer and the remote Exchange 2013 server.

Import-RecipientDataProperty-Identity "Tony Смит" -спокеннаме-FileData ([Byte []] $ (Get-Content-Path "м:\аудиофилес\тонисмис.ВМА" -Encoding Byte-реадкаунт 0))Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([Byte[]]$(Get-Content -Path "M:\AudioFiles\TonySmith.wma" -Encoding Byte -ReadCount 0))

Эта команда служит примером синтаксиса (выделенного курсивом), необходимого для импорта файла на удаленный сервер Exchange 2013 с использованием параметра FileData в командлете.This command shows an example of the syntax, shown in italics, required to import a file into a remote Exchange 2013 server using the FileData parameter on a cmdlet. Синтаксис инкапсулирует данные, содержащиеся в файле M:\AudioFiles\TonySmith.wma, и передает их в потоковом режиме в свойство FileData командлета Import-RecipientDataProperty.The syntax encapsulates the data contained in the M:\AudioFiles\TonySmith.wma file and streams the data to the FileData property on the Import-RecipientDataProperty cmdlet.

Параметр FileData принимает данные из файла на локальном компьютере при использовании данного синтаксиса в большинстве командлетов.The FileData parameter accepts data from a file on your local computer using this syntax on most cmdlets.

Export — RecipientDataProperty — Identity tony@contoso.com — Спокеннаме | ForEach {$ _. FileData | Add/Content К:\тонисмис.ВМА — кодирование байта}Export-RecipientDataProperty -Identity tony@contoso.com -SpokenName | ForEach {$_.FileData | Add-Content C:\tonysmith.wma -Encoding Byte}

Эта команда служит примером синтаксиса (выделенного курсивом), необходимого для экспорта файла с удаленного сервера Exchange 2013.This command shows an example of the syntax, shown in italics, required to export a file from a remote Exchange 2013 server. Синтаксис инкапсулирует данные, хранящиеся в свойстве FileData объекта, возвращаемого командлетом, и передает эти данные в потоковом режиме на локальный компьютер.The syntax encapsulates the data stored in the FileData property on the object returned by the cmdlet and then streams the data to your local computer. Затем данные сохраняются в файле C:\tonysmith.wma.The data is then stored in the C:\tonysmith.wma file.

Большинство командлетов, возвращающих объекты со свойством FileData, используют этот синтаксис для экспорта данных в файлы на локальном компьютере.Most cmdlets that output objects with a FileData property use this syntax to export data to a file on your local computer.