Add-AvailabilityAddressSpace

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

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

Максимальное число адресов доступности, возвращаемых Active Directory в Exchange, равно 100. Мы рекомендуем использовать не более 100 адресных пространств для корректной работы запросов сведений о доступности.

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

Синтаксис

Add-AvailabilityAddressSpace
   -AccessMethod <AvailabilityAccessMethod>
   -ForestName <String>
   [-Confirm]
   [-Credentials <PSCredential>]
   [-DomainController <Fqdn>]
   [-ProxyUrl <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-UseServiceAccount <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Описание

В Exchange Online перед выполнением командлета Add-AvailabilityAddressSpace необходимо выполнить командлет New-AvailabilityConfig.

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

Примеры

Пример 1

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod OrgWideFB -Credentials (Get-Credential)

Этот пример полезен при использовании службы доступности в топологиях "перекрестный лес" в лесах без отношения доверия, либо в ситуации, когда пересылка подробных данных о занятости между лесами нежелательна. Введите имя пользователя и пароль, когда вам будет предложено выполнить команду. В конфигурации с несколькими лесами без отношения доверия убедитесь, что у пользователя нет почтового ящика.

Пример 2

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod PerUserFB -Credentials (Get-Credential)

Этот пример особенно полезен при использовании совместно с доверенной межлесной службой доступности. Лес contoso.com доверяет текущему лесу и указанная учетная запись подключается к лесу contoso.com. Указанная учетная запись должна быть существующей учетной записью в лесу contoso.com.

Пример 3

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod PerUserFB -UseServiceAccount $true

Этот пример особенно полезен при использовании совместно с доверенной межлесной службой доступности. Лес contoso.com доверяет текущему лесу, для подключения к лесу contoso.com используется учетная запись службы (обычно это локальная системная учетная запись или учетная запись компьютера). Поскольку служба является доверенной, не возникает проблем с авторизацией, когда текущий лес предпринимает попытку извлечь данные о занятости с сервера contoso.com.

Параметры

-AccessMethod

Параметр AccessMethod указывает особенности доступа к сведениям о занятости. Допустимые значения:

  • PerUserFB: можно запросить сведения о доступности и доступности для каждого пользователя. Доступ к данным о доступности осуществляется в определенной учетной записи или группе прокси-сервера для каждого пользователя или в группе Все серверы Exchange Server. Это значение требует отношения доверия между двумя лесами и требует использования параметра UseServiceAccount или Credentials.
  • OrgWideFB: для каждого пользователя можно запрашивать только значение доступности по умолчанию. Доступ к данным о доступности осуществляется в учетной записи прокси-сервера или группе доступности для каждого пользователя в целевом лесу. Для этого значения необходимо использовать параметр UseServiceAccount или Credentials.
  • OrgWideFBBasic: это значение зарезервировано для внутренних Майкрософт использования.
  • InternalProxy: запрос передается прокси-серверу Exchange на сайте с более поздней версией Exchange.
  • PublicFolder: это значение использовалось для доступа к данным о доступности на серверах Exchange Server 2003.
Type:AvailabilityAccessMethod
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Credentials

Параметр Credentials указывает имя пользователя и пароль, используемые для доступа к службам доступности в целевом лесу.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

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

-DomainController

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

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

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

-ForestName

Параметр ForestName указывает имя домена SMTP конечного леса для пользователей, чьи сведения о доступности необходимо получить. Если пользователи распределены среди нескольких доменов SMTP в конечном лесе, выполните команду Add-AvailabilityAddressSpace для каждого домена SMTP.

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

-ProxyUrl

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

Параметр ProxyUrl использовался для указания URL-адреса, направляющего сервер клиентского доступа Exchange 2007 на прокси-сервер свободного доступа через сервер клиентского доступа Exchange 2010 или Exchange 2013 при запросе федеративных данных о доступности для пользователя в другой организации. При использовании этого параметра требовалось присваивать параметру AccessMethod значение InternalProxy.

Для этого параметра необходимо создать правильные отношения доверия и отношения общего доступа между организациями Exchange. Дополнительные сведения см. в разделе New-FederationTrust.

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

-TargetAutodiscoverEpr

Параметр TargetAutodiscoverEpr указывает URL-адрес автообнаружения веб-служб Exchange для внешней организации, например https://contoso.com/autodiscover/autodiscover.xml. Exchange использует автообнаружения для автоматического обнаружения правильной конечной точки сервера для внешних запросов.

Type:Uri
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, Exchange Online, Exchange Online Protection

-UseServiceAccount

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

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

  • $true. Для авторизации используется локальная учетная запись службы доступности.
  • $false: локальная учетная запись службы доступности не используется для авторизации. Необходимо использовать параметр Credentials.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

Input types

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

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

Output types

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