Add-AvailabilityAddressSpace
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Используйте командлет Add-AvailabilityAddressSpace для создания объектов адресного пространства доступности, которые используются для совместного использования данных о доступности в организациях Exchange.
Максимальное число адресов доступности, возвращаемых Active Directory в Exchange, равно 100. Мы рекомендуем использовать не более 100 адресных пространств для корректной работы запросов сведений о доступности.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Add-AvailabilityAddressSpace
-AccessMethod <AvailabilityAccessMethod>
-ForestName <String>
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ProxyUrl <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetServiceEpr <String>]
[-TargetTenantId <String>]
[-UseServiceAccount <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
В Exchange Online перед выполнением командлета Add-AvailabilityAddressSpace необходимо выполнить командлет New-AvailabilityConfig.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Add-AvailabilityAddressSpace -ForestName contoso.com -AccessMethod OrgWideFB -Credentials (Get-Credential)
В локальной среде Exchange этот пример полезен для ненадежной службы доступности между лесами или в том случае, если подробные сведения о доступности между лесами не требуется. Введите имя пользователя и пароль, когда вам будет предложено выполнить команду. В конфигурации с несколькими лесами без отношения доверия убедитесь, что у пользователя нет почтового ящика.
Пример 2
Add-AvailabilityAddressSpace -ForestName contoso.com -AccessMethod PerUserFB -Credentials (Get-Credential)
В локальной среде Exchange этот пример полезен для доверенной службы доступности между лесами. Лес contoso.com доверяет текущему лесу и указанная учетная запись подключается к лесу contoso.com. Указанная учетная запись должна быть существующей учетной записью в лесу contoso.com.
Пример 3
Add-AvailabilityAddressSpace -ForestName contoso.com -AccessMethod PerUserFB -UseServiceAccount $true
В локальной среде Exchange этот пример полезен для доверенной службы доступности между лесами. Лес contoso.com доверяет текущему лесу, для подключения к лесу contoso.com используется учетная запись службы (обычно это локальная системная учетная запись или учетная запись компьютера). Поскольку служба является доверенной, не возникает проблем с авторизацией, когда текущий лес предпринимает попытку извлечь данные о занятости с сервера contoso.com.
Пример 4
Add-AvailabilityAddressSpace -ForestName contoso.onmicrosoft.com -AccessMethod OrgWideFBToken -TargetTenantId "9d341953-da1f-41b0-8810-76d6ef905273" -TargetServiceEpr "outlook.office.com"
В Exchange Online в этом примере настраивается общий доступ к сведениям о доступности с contoso.onmicrosoft.com (значение идентификатора клиента 9d341953-da1f-41b0-8810-76d6ef905273), которая является обычной организацией Microsoft 365.
Параметры
-AccessMethod
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр AccessMethod указывает особенности доступа к сведениям о занятости. Допустимые значения:
- PerUserFB: можно запросить сведения о доступности и доступности для каждого пользователя. Доступ к данным о доступности осуществляется в определенной учетной записи или группе прокси-сервера для каждого пользователя или в группе Все серверы Exchange Server. Это значение требует отношения доверия между двумя лесами и требует использования параметра UseServiceAccount или Credentials.
- OrgWideFB: можно запросить только значение доступности по умолчанию для каждого пользователя. Доступ к данным о доступности осуществляется в учетной записи прокси-сервера или группе доступности для каждого пользователя в целевом лесу. Для этого значения необходимо использовать параметр UseServiceAccount или Credentials. Это значение не рекомендуется использовать для доступа к целевым лесам в Exchange Online.
- OrgWideFBToken: используется для общего доступа между двумя клиентами в Exchange Online. Можно запросить только значение доступности по умолчанию для каждого пользователя. Для этого значения также требуется задать параметры TargetTenantId и TargetServiceEpr.
- InternalProxy: запрос передается прокси-серверу Exchange на сайте, на котором запущена более поздняя версия Exchange.
- PublicFolder: это значение использовалось для доступа к данным о доступности на серверах Exchange Server 2003.
Свойства параметров
| Тип: | AvailabilityAccessMethod |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credentials
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр Credentials указывает имя пользователя и пароль, используемые для доступа к службам доступности в целевом лесу.
Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.
Свойства параметров
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForestName
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр ForestName указывает доменное имя SMTP целевого леса, содержащего пользователей, с которыми вы пытаетесь прочитать сведения о доступности. Если пользователи распределены между несколькими доменами SMTP в целевом лесу, выполните команду Add-AvailabilityAddressSpace один раз для каждого домена SMTP.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ProxyUrl
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр ProxyUrl использовался для указания URL-адреса, направляющего сервер клиентского доступа Exchange 2007 в прокси-запросы о доступности через сервер клиентского доступа Exchange 2010 или Exchange 2013 при запросе федеративных данных о доступности для пользователя в другой организации. При использовании этого параметра необходимо задать для параметра AccessMethod значение InternalProxy.
Для этого параметра необходимо создать правильные отношения доверия и отношения общего доступа между организациями Exchange. Дополнительные сведения см. в разделе New-FederationTrust.
Свойства параметров
| Тип: | Uri |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TargetAutodiscoverEpr
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Встроенная надстройка безопасности для локальных почтовых ящиков
Параметр TargetAutodiscoverEpr указывает URL-адрес автообнаружения веб-служб Exchange для внешней организации, из которую вы пытаетесь считывать сведения о доступности. Например, https://contoso.com/autodiscover/autodiscover.xml. Exchange использует автообнаружения для автоматического обнаружения правильной конечной точки сервера для внешних запросов.
Свойства параметров
| Тип: | Uri |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TargetServiceEpr
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр доступен только в облачной службе.
Параметр TargetServiceEpr указывает Exchange Online адрес внешней организации Microsoft 365, из которую вы пытаетесь считывать сведения о доступности. Допустимые значения:
- Microsoft 365 или Microsoft 365 GCC: outlook.office.com
- Office 365 управляется компанией 21Vianet: partner.outlook.cn
- Microsoft 365 GCC High или DoD: outlook.office365.us
Этот параметр используется только в том случае, если параметр AccessMethod имеет значение OrgWideFBToken.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TargetTenantId
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр доступен только в облачной службе.
Параметр TargetTenantID указывает идентификатор клиента внешней организации Microsoft 365, из которую вы пытаетесь считывать сведения о доступности.
Этот параметр используется только в том случае, если параметр AccessMethod имеет значение OrgWideFBToken.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseServiceAccount
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр UseServiceAccount указывает, следует ли использовать локальную учетную запись службы доступности для авторизации. Допустимые значения
- $true. Для авторизации используется локальная учетная запись службы доступности.
- $false: локальная учетная запись службы доступности не используется для авторизации. Необходимо использовать параметр Credentials.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.