Get-CmdletExtensionAgent

Модуль:

Exchange PowerShell

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

Используйте командлет Get-CmdletExtensionAgent для просмотра агентов расширения командлетов.

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

Синтаксис

Filters

Get-CmdletExtensionAgent
    [-Assembly <String>]
    [-Enabled <Boolean>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Identity

Get-CmdletExtensionAgent
    [[-Identity] <CmdletExtensionAgentIdParameter>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Описание

Агенты расширения командлетов используются командлетами Exchange в Exchange Server 2010 и более поздних версиях. Командлеты, предоставляемые другими продуктами Майкрософт или сторонними продуктами, не могут использовать агенты расширения командлетов.

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

Примеры

Пример 1

Get-CmdletExtensionAgent | Format-Table -Auto Name,Enabled,Priority

В этом примере отображается сводный список всех агентов расширения командлетов в организации.

Пример 2

Get-CmdletExtensionAgent "Mailbox Creation Time Agent"

В этом примере отображаются подробные сведения для агента расширения командлета Exchange с именем Почтовый агент времени создания почтовых ящиков.

Параметры

-Assembly

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Assembly фильтрует результаты по указанному значению свойства Assembly. Значение для встроенных агентов расширения командлетов Exchange — Microsoft.Exchange.ProvisioningAgent.dll.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

Filters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Enabled

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Enabled фильтрует результаты по включенным или отключенным агентам расширения командлетов. Допустимые значения:

• $true. В результаты включаются только включенные агенты.
• $false. В результаты включаются только отключенные агенты.

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

Свойства параметров

Тип:	Boolean
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

Filters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Identity

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

• имя;
• различающееся имя (DN);
• GUID

Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.

Свойства параметров

Тип:	CmdletExtensionAgentIdParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

Identity

Position:	1
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.