Reset-ProvisioningCache

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Этот командлет доступен только в локальной среде Exchange.

Командлет Reset-ProvisioningCache очищает кэш подготовки Windows PowerShell часто используемых объектов Active Directory. Этот командлет используется только в диагностических целях.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>
     [-GlobalCache]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>]
     [-CurrentOrganization]
     [-Organizations <MultiValuedProperty>]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

Описание

Командлет Reset-ProvisioningCache используется редко и только в диагностических целях. Администраторы Exchange должны выполнять этот командлет только в том случае, если на новых подготовленных получателях помечены неправильные ссылки или свойства, что может быть вызвано устаревшими данными в кэше подготовки. Это редко случается, так как кэш наполнения использует логику уведомления о несоответствиях.

Командлет Reset-ProvisioningCache очищает кэш подготовки Windows PowerShell часто используемых объектов Active Directory. Чтобы сократить число запросов Active Directory, кэш подготовки инициализируется в каждом Windows PowerShell пространстве выполнения и используется для кэширования распространенных объектов, которые часто используются командлетами и обработчиками подготовки. Во время выполнения командлета Exchange кэш подготовки загружает объекты конфигурации из Active Directory для выполнения командлета. Например, при создании почтового ящика командлет New-Mailbox получает свойства из Active Directory. При выполнении командлетов объекты конфигурации, такие как контейнеры баз данных, группы административных ролей и устаревшие именаDN, извлекаются из Active Directory. Поскольку эти типы объектов являются стабильными и не изменяются в течение нескольких месяцев или лет после их создания, они хранятся в кэше подготовки, используемом Windows PowerShell. Это увеличивает эффективность подготовки и значительно улучшает производительность командлета.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Reset-ProvisioningCache -Server EXSRV1.contoso.com -Application Powershell -GlobalCache

В этом примере выполняется сброс кэша подготовки для Windows PowerShell, запущенных на сервере EXSRV1.contoso.com в локальной организации Exchange, и указывается, что все ключи кэша очищаются.

Пример 2

Reset-ProvisioningCache -Application Powershell-Proxy -Server datacenter1.adatum.com -GlobalCache

Этот пример выполняется в мультитенантном развертывании администратором центра обработки данных для сброса кэша подготовки для Windows PowerShell клиента adatum.com и очистки всех ключей кэша.

Параметры

-Application

Параметр Application указывает определенное административное приложение, для которого необходимо сбросить кэш наполнения. Можно использовать следующие значения:

Powershell
Powershell-LiveId
Powershell-Proxy
PowershellLiveId-Proxy
Ecp
Psws

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CacheKeys

Параметр CacheKeys задает значение ключа кэша, который требуется очистить. Формат значений должен содержать 32 цифры, разделенные четырьмя дефисами: xxxxxxx-xxxx-xxxx-xxxx-xxxxxx.

Командлет Dump-ProvisioningCache используется для возвращения списка разделов кэша.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CurrentOrganization

Параметр CurrentOrganization сбрасывает кэш подготовки для организации. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GlobalCache

Параметр GlobalCache очищает все ключи кэша. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Organizations

Параметр Organizations указывает организации, для которых необходимо выполнить сброс кэша. Этот параметр используется при развертываниях с несколькими клиентами

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Параметр Server указывает полное доменное имя (FQDN) сервера с приложением, сброс которого необходимо выполнить.

Type:	Fqdn
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.