Полезные командлеты Powershell для Exchange

[albatros]

Проверить права
Get-ManagementRole "MyVoiceMail" | Format-Table Name, IsEndUserRole
После того, как роль была подтверждена как роль конечного пользователя, она назначается политике назначения ролей «Конечные пользователи продаж».
New-ManagementRoleAssignment -Role "MyVoiceMail" -Policy "Sales end-users"

 

[quake]

Порядок установки CU на Exchange Server
1.
Переводим компонент сервера Hub Transport в режим обслуживания:
Set-ServerComponentState MAIL2 –Component HubTransport –State Draining –Requester Maintenance
2.
Переводим все активные сообщения из очередей почтового сервера на другой сервер (нужно указать FQDN севера):
Redirect-Message -Server MAIL2 -Target mail1.rew.local
Подтверждаем нажатием Y

3.Приостанавливаем членство в кластере:
Suspend-ClusterNode –Name MAIL2

4.Следующая команда перемещает все активные копии баз данных с сервера MAIL2 и блокирует политику активацию новых копий:
Set-MailboxServer MAIL2 –DatabaseCopyActivationDisabledAndMoveNow $true

5.Переводим сервер в режим обслуживания:
Set-ServerComponentState MAIL2 -Component ServerWideOffline –State InActive –Requester Maintenance

6. На cmd.exe от имени Администратора

setup.exe /prepareschema /IAcceptExchangeServerLicenseTerms
setup.exe /preparead /IAcceptExchangeServerLicenseTerms
setup.exe /PrepareDomain /IAcceptExchangeServerLicenseTerms

Устанавливаем CU:
setup.exe /m:upgrade /IAcceptExchangeServerLicenseTerms_DiagnosticDataON

-------------------

После установки возвращаем все в рабочее состояние:

Resume-ClusterNode –Name MAIL2
Set-MailboxServer MAIL2 –DatabaseCopyAutoActivationPolicy Unrestricted
Set-MailboxServer MAIL2 –DatabaseCopyActivationDisabledAndMoveNow $false
Set-ServerComponentState MAIL2 –Component HubTransport –State Active –Requester Maintenance

Возвращаем персональные настройки виртуальных каталогов (если они были сделаны).
Раскидываем базы данных, согласно приоритету активации, для этого переходим в папку C:\Program Files\Microsoft\Exchange Server\V15\scripts и выполняем команду:

.\RedistributeActiveDatabases.ps1 –DagName DAGNAME –BalanceDbsByActivationPreference –confirm: $false
Set-ServerComponentState MAIL2 -Component ServerWideOffline -State Active -Requester Maintenance
Проверяем что все компоненты запустились:
Get-ServerComponentState MAIL2 -Component ServerWideOffline
Готово. Проверяем репликацию:
Test-ReplicationHealth -Identity MAIL2

Осталось убедиться в отсутствии проблем у пользователей и сторонних сервисов и можно приступать к обновлению следующего сервера.

 

[ExchAdm]

Поиск письма по домену, на который оно было отправлено из вашей компании. Т.е. все письма отправленные на домен @mail.ru:

Get-TransportService | Get-MessageTrackingLog -Start "10/15/2022 11:00:00" -End "10/18/2022 11:00:00" -ResultSize Unlimited | where {[string]$_.recipients -like "*@mail.ru"} | Select-Object Timestamp,Sender,{$_.Recipients},MessageSubject,ReturnPath,{$_.RecipientStatus},Source,EventId,InternalMessageId,MessageId,NetworkMessageId | Export-Csv C:\DomainFile01.csv -NoTypeInformation

Поиск по алиасу получателя внутри компании. Т.е. все письма, которые были направлены на алиас вашего сотрудника как от внутренних сотрудников, так и внешних отправителей:

Get-TransportService | Get-MessageTrackingLog -Recipients MyAlias@adatum.com -Start "10/15/2022 11:00:00" -End "10/18/2022 11:00:00" -ResultSize Unlimited | where {($_.EventID -eq "RECEIVE") -and ($_.Recipients -eq "MyAlias@adatum.com")} | sort Timestamp -Descending | Select-Object Timestamp,Sender,{$_.Recipients},MessageSubject,MessageId,ReturnPath | Export-Csv C:\AliasFile02.csv -NoTypeInformation

 

[ExchAdm]

Как узнать было ли прочитано сообщение отправленное одним внутренним отправителем другому внутреннему отправителю (например от начальника к подчинённому)?

В примере на скриншоте на моём Exchange есть несколько обслуживаемых доменов и показан пример того, что отправленное сообщение с почты в домене '.su' на почту в домене '.ru' было прочитано. Если же сообщение не было бы прочитано, то надписи 'Read' не было бы. Если человек прочитал сообщение, а потом отметил его непрочитанным, то в трекинге оно всё равно будет отображаться прочитанным.

Get-TransportService | Get-MessageTrackingLog -Sender BOSS@adatum.com -Recipients Vladimir@adatum.com -MessageSubject "Urgent task from CEO" | Select-Object -First 1 | fl Sender,Recipients,MessageSubject,MessageID

$Temp = Search-MessageTrackingReport -Identity Vladimir@adatum.com -Sender BOSS@adatum.com -MessageId dq23765f1c2b7035ad61821ba332hfa4@adatum.com -BypassDelegateChecking -DoNotResolve

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate RecipientPath -RecipientPathFilter Vladimir@adatum.com -BypassDelegateChecking

Всё вышенаписанное было сделано на основе статьи: https://practical365.com/tracking-read-email-messages-exchange-server/ где есть интересное уточнение:

Непрочитанное сообщение в папке «Входящие» и непрочитанное сообщение, которое было удалено [без прочтения], будут неотличимы друг от друга при просмотре отчетов о доставке.

Если появляется ошибка конвертации параметра в Identity, то вместо $Temp.MessageTrackingReportID надо писать $Temp.MessageTrackingReportID.rawidentity

 

[NanoSuit]

Посмотреть используемые мобильные устройства activesync и удалить, если необходимо

Get-ActiveSyncDevice -Mailbox username |fl identity, first*, devicemodel
Remove-ActiveSyncDevice -Identity "device identity"

 

[NanoSuit]

Если вам действительно нужно более 10 устройств, вы можете изменить политику EASMaxDevices. Лучшая практика заключается в том, чтобы минимизировать число устройств. Используйте приведенные ниже команды, чтобы установить количество устройств равным 20.

New-Throttlingpolicy "Increased ActiveSync Devices" -EasMaxDevices 20 -EasMaxConcurrency 20
Set-Mailbox username -ThrottlingPolicy "Increased ActiveSync Devices"

 

[ExchAdm]

В дополнение к посту выше об отслеживании ActiveSync устройств (iOS, Android, etc) нужно было понять, какие устройства давно не подключались к Exchange и я нашёл прекрасный скрипт, который явно говорит сколько дней назад устройство связывалось с Exchange сервером.

Скриншот с моего стенда.

Отмечу, что если в рамках леса есть несколько доменов, то, к сожалению, скрипт получает данные только из того домена, откуда был запущен. Если кто-то подскажет что нужно модифицировать (я, к сожалению, в PowerShell далеко не эксперт), то буду премного благодарен.
UPD: оказалось, если не править сам скрипт, то достаточно выполнить в EMS командлет Set-ADServerSettings -ViewEntireForest:$true и тогда в выгрузку попадут устройства из всех доменов леса.

Get-EASDeviceReport.ps1 Script to Report on ActiveSync Devices

This PowerShell script produces a simple report of the ActiveSync device associates in an Exchange organization.

practical365.com

GitHub - cunninghamp/Get-EASDeviceReport.ps1: This PowerShell script produces a simple report of the ActiveSync device associates in an Exchange organization.

This PowerShell script produces a simple report of the ActiveSync device associates in an Exchange organization. - cunninghamp/Get-EASDeviceReport.ps1

github.com

 

[Fedor]

Просмотр транспортной очереди
Get-Exchangeserver * | Get-Queue | ft

 

[Surf_rider]

Поиск по вложению в письме в exchange
Get-MailBox -Identity user@domen.ru | Search-Mailbox -SearchQuery attachment:'secret word' -DeleteContent

 

[Trunk]

Узнать ExchangeGuid почтовых ящиков
Get-Mailbox | Sort Name | ft Name,ExchangeGuid

 

[Giroskop]

Поиск ящика по SMTP адресу
Get-Mailbox -ResultSize Unlimited -Filter {EmailAddresses -like "username@domain.com"} | Sort-Object Name

Удобно искать пользователей давно не подключавшихся

Get-ADUser -filter {enabled -eq $false} -Properties LastLogonTimeStamp -SearchBase ‘OU=Users,OU=OFFICE,OU=Main,DC=domen,DC=local’ | Select-Object Name, @{N='LastLogonTimeStamp '; E={[DateTime]::FromFileTime($_.LastLogonTimeStamp )}}| Sort LastLogonTimeStamp

Name lastlogontimestamp
---- ------------------
Ivanov Ivan1 06.12.2023 11:15:51
Ivanov Ivan2 26.01.2024 11:23:24

 

[Surf_rider]

Простейший скрипт по очистке старых логов exchange в каталогах

C:\Program Files\Microsoft\Exchange Server\V15\Logging\
С:\Program Files\Microsoft\Exchange Server\V15\Bin\Search\Ceres\Diagnostics\ETLTraces\

Внутри скрипта есть количество дней старше которых логи удалять (надо выставить по вкусу). Так же логика работы понятна.
Понятно что не совсем все это правильно с точки зрения настроек, но иногда как говорится нет времени объяснять...

 

[Surf_rider]

Поиск отправленных писем за период
Get-MessageTrackingLog -Start 2025-01-01 -End 2025-01-31 -Sender test01@contoso.local -EventId "SEND" | Measure-Object | Select-Object Count

 

[volodya773]

Поиск и удаление прав пользователя на общих почтовых ящиках

                $SharedMailboxes = Get-Mailbox -RecipientTypeDetails SharedMailbox
                $UserCN = Get-ADUser -Identity $uSam -Properties CanonicalName
                foreach ($Mailbox in $SharedMailboxes) {
                $MailboxName = $Mailbox.DisplayName
                $MailboxIdentity = $Mailbox.Identity
# Проверить права полного доступа
                $FullAccessPermissions = Get-MailboxPermission -Identity $MailboxIdentity |
                Where-Object {($_.User -like "*$uSam*") -and ($_.AccessRights -contains "FullAccess")}
                if ($FullAccessPermissions) {
                Write-Host "Права полного доступа найдены для пользователя $uSam на ящик $MailboxName. Удаление..."
                Remove-MailboxPermission -Identity $MailboxIdentity -User $uSam -AccessRights FullAccess -InheritanceType All -Confirm:$false
                Write-Host "Права полного доступа удалены." -ForegroundColor Green
                 }  else {
                Write-Host "Права полного доступа отсутствуют $MailboxName." -ForegroundColor Yellow
                        }
# Проверить права отправки от имени
                $SendAsPermissions = Get-RecipientPermission -Identity $MailboxIdentity |
                Where-Object {($_.Trustee -like $UserCN.CanonicalName) -and ($_.AccessRights -contains "SendAs")}
                 if ($SendAsPermissions) {
                 Write-Host "Права отправки от имени найдены для пользователя $uSam на ящик $MailboxName. Удаление..."
                 Remove-RecipientPermission -Identity $MailboxIdentity -Trustee $UserCN.CanonicalName -AccessRights SendAs -Confirm:$false
                 Write-Host "Права отправки от имени удалены." -ForegroundColor Green
                 } else {
        Write-Host "Права отправки от имени отсутствуют $MailboxName." -ForegroundColor Yellow
                     }
             }

 

[dimon]

Немного примеров использования командлета Get-MessageTrackingLog
Очень часто бывает нужно найти какое то письмо, или кто кому что отправлял

Поиск определенных писем от отправителя до получателя с перенаправлением вывода в текстовый файл. Так же указано какие поля нам интересны
Get-MessageTrackingLog -Sender 'sender@sender.ru' -Recipients 'recipient@recipient.ru' | select timestamp,messageid,messagesubject | FL > c:\result.txt

Поиск определенных писем в логах от отправителя - получателя с перенаправлением результатов в текстовый файлик
Get-MessageTrackingLog -Sender 'sender@sender.ru' -Recipients 'recipient@recipient.ru' | select * | FL > c:\result.txt

Так же поиск писем за последние 12 часов
Get-MessageTrackingLog -Start (Get-Date).AddHours(-12) -ResultSize unlimited | where {[string]$_.recipients -like "recipient@recipient.ru"} | FT -AutoSize

Поиск писем в логах с указанием интервала времени и выводом в текстовый файл
Get-MessageTrackingLog -ResultSize unlimited -Sender "sender@sender.ru" -Recipients "recipient@recipient.ru" -server MAIL -Start "02/01/2025 08:00:00" -End "04/04/2025 21:00:00" |select-object Timestamp,Sender,Recipients,MessageSubject,EventId|ft -AutoSize > c:\result.txt

 

[Surf_rider]

Включить анонимную ретрансляцию в Exchange (allow anonymous relay)

1. Создаем коннектор и указываем ip с которых разрешен anonymous relay
New-ReceiveConnector -Name "Anonymous Relay" -TransportRole FrontendTransport -Custom -Bindings 0.0.0.0:25 -RemoteIpRanges 192.168.5.10,192.168.5.11

2. Настройка анонимных соединений
Set-ReceiveConnector "Anonymous Relay" -PermissionGroups AnonymousUsers
Get-ReceiveConnector "Anonymous Relay" | Add-ADPermission -User "NT AUTHORITY\ANONYMOUS LOGON" -ExtendedRights "Ms-Exch-SMTP-Accept-Any-Recipient"
Set-ReceiveConnector "Anonymous Relay" -AuthMechanism ExternalAuthoritative -PermissionGroups ExchangeServers
Проверить что получилось
Get-ReceiveConnector "Anonymous Relay" | Format-List Enabled,TransportRole,Bindings,RemoteIPRanges

Get-ADPermission "Anonymous Relay" -User "NT AUTHORITY\ANONYMOUS LOGON" | where {($_.Deny -eq $false) -and ($_.IsInherited -eq $false)} | Format-Table User,ExtendedRights

Используйте Telnet, чтобы проверить подключение одного или нескольких указанных узлов сети к выделенному соединителю получения и анонимную ретрансляцию почты через соединитель.

 

[Surf_rider]

Указать БД для архивов на месте с указанием квот
Set-Mailbox -Identity USERNAME -ArchiveDatabase ARCHDB01 -ArchiveQuota 25GB -ArchiveWarningQuota 20GB

 

[Anatoly]

Массовое создание групп рассылки Distribution group

1.Перемещаем группы в отдельную OU, допустим distribution groups
2.Делаем тип Universal - Distribution
Get-ADGroup -SearchBase "OU=distribution groups,OU=MAIN,DC=domen,DC=local" -filter * | Set-ADGroup -GroupScope Universal -GroupCategory Distribution

4.Выгружаем в CSV
Get-ADGroup -SearchBase "OU=distribution groups,OU=MAIN,DC=domen,DC=local" -filter * | Sort Name | Select-Object Name,GroupCategory | Export-csv C:\scripts\dg.csv

CSV должен быть вида
Name,Type
Allusers,Distribution

5. Создаем группы
Import-CSV "c:\scripts\dg.csv" | foreach {New-DistributionGroup -Name $_.name -Type $_.Type}
6. Включаем получение от внешних адресов
Get-Distributiongroup | Set-DistributionGroup -RequireSenderAuthenticationEnabled $false

 

[Surf_rider]

Отключить почтовые ящики всем юзерам в конкретной OU
Get-Mailbox -OrganizationalUnit "OU=disabled users,OU=MAIN,DC=DOMEN,DC=LOCAL" | Disable-Mailbox

 

[Surf_rider]

Миграция ящика

Get-MailBox –Server mail | New-MoveRequest –TargetDatabase “MailBox Database 1”

Посмотреть процесс

Get-MoveRequest | Get-MoveRequestStatistics