Get-StoreUsageStatistics
Этот командлет доступен только в локальной среде Exchange.
Командлет Get-StoreUsageStatistics используется для диагностики проблем производительности серверов и баз данных.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Database
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Identity
Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Server
Get-StoreUsageStatistics
-Server <ServerIdParameter>
[-IncludePassive]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Описание
Банк данных Microsoft Exchange собирает информацию для каждого пользователя о задержке, вводе-выводе (I/O), количестве страниц, использовании процессора и TimeInServer. Метрика TimeInServer представляет общее время, которое синхронные и асинхронные запросы тратят на почтовый ящик пользователя в банке данных Microsoft Exchange. Эти сведения можно получить в банке данных Microsoft Exchange для 25 учетных записей с наибольшим использованием в указанной базе данных. Использование почтового ящика определяется как количество времени сервера, потребовавшегося для выполнения операций для этого почтового ящика. Командлет передает 25 ведущих пользователей по каждому 1-минутному периоду за последние 10 минут (250 объектов за 10 минут). Использование ресурсов представляет собой показатель нагрузки, возлагаемой на сервер различными пользователями.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-StoreUsageStatistics -Server EX1 | ft -auto
В этом примере показано получение статистики использования хранилища по всем активным базам данных на сервере EX1.
Пример 2
Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto
В этом примере показано получение статистики использования хранилища по всем активным и пассивным базам данных на сервере EX1.
Пример 3
Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto
В этом примере извлекается статистика использования хранилища для базы данных DB1 и сортируются выходные данные по 10 самым большим генераторам файлов журнала.
Параметры
-CopyOnServer
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр CopyOnServer указывает копию базы данных почтовых ящиков, из которой берется статистика использования. Можно использовать любое значение, однозначно определяющее базу данных почтовых ящиков. Например:
- имя;
- различающееся имя (DN);
- GUID
Этот параметр используется вместе с параметрами Server или Identity.
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Database
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Database задает имя базы данных почтовых ящиков, из которой берется статистика использования (25 самых больших почтовых ящиков в указанной базе данных почтовых ящиков). Можно использовать любое значение, однозначно определяющее базу данных почтовых ящиков. Например:
- имя;
- различающееся имя (DN);
- GUID
Этот параметр нельзя использовать с параметрами Identity или Server.
Свойства параметров
| Тип: | DatabaseIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filter
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Filter использует синтаксис OPATH для фильтрации результатов по указанным свойствам и значениям. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".
- Заключите весь фильтр OPATH в двойные кавычки " ". Если фильтр содержит системные значения (например,
$true,$falseили$null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq, для равенства и-likeдля строкового сравнения). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'или'$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'используйте'$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте500,$true,$false, или$nullвместо них).
Вы можете объединить несколько условий поиска в цепочку с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".
Подробные сведения о фильтрах OPATH в Exchange см. в статье "Дополнительные сведения о синтаксисе OPATH".
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Identity указывает почтовый ящик, из которого берется статистика использования. Для идентификации почтового ящика можно использовать одно из следующих значений:
- GUID
- Различающееся имя (DN)
- Домен\Учетная запись
- Имя участника-пользователя (UPN)
- Устаревший Exchange DN
- SMTP-адрес
- Псевдоним
Команда возвращает результаты для почтового ящика, только если это один из 25 крупнейших пользователей ресурсов Store.
Этот параметр нельзя использовать с параметрами базы данных или сервера.
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | GeneralMailboxIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludePassive
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ключ IncludePassive определяет, следует ли включать статистику использования из активных и пассивных копий баз данных почтовых ящиков на сервер почтовых ящиков, указанный с помощью параметра Server. С этим параметром не нужно указывать значение.
Если этот переключатель не используется, в результаты включается только статистика активных копий баз данных почтовых ящиков.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Server
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Server указывает сервер почтовых ящиков, с которого берется статистика использования (25 основных почтовых ящиков во всех активных базах данных на указанном сервере). Для идентификации сервера можно использовать одно из следующих значений:
- Полное доменное имя (FQDN)
- NetBIOS-имя
Этот параметр нельзя использовать с параметрами Database или Identity.
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Server
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.