Поделиться через

Set-ClientAccessRule

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Примечание.

Начиная с октября 2022 г. правила клиентского доступа стали устаревшими для всех Exchange Online организаций, которые их не использовали. С 1 сентября 2025 г. правила доступа клиентов будут нерекомендуемы для всех остальных организаций. Если вы решили отключить правила доступа клиентов до наступления крайнего срока, функция будет отключена в вашей организации. Дополнительные сведения см. в статье Обновление правил клиентского доступа в Exchange Online.

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

Командлет Set-ClientAccessRule используется для изменения существующих правил клиентского доступа. Правила клиентского доступа помогают управлять доступом к организации на основе свойств подключения.

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

Синтаксис

Set-ClientAccessRule
   [-Identity] <ClientAccessRuleIdParameter>
   [-Action <ClientAccessRulesAction>]
   [-AnyOfAuthenticationTypes <MultiValuedProperty>]
   [-AnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
   [-AnyOfProtocols <MultiValuedProperty>]
   [-AnyOfSourceTcpPortNumbers <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptAnyOfAuthenticationTypes <MultiValuedProperty>]
   [-ExceptAnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
   [-ExceptAnyOfProtocols <MultiValuedProperty>]
   [-ExceptAnyOfSourceTcpPortNumbers <MultiValuedProperty>]
   [-ExceptUserIsMemberOf <MultiValuedProperty>]
   [-ExceptUsernameMatchesAnyOfPatterns <MultiValuedProperty>]
   [-Name <String>]
   [-Priority <Int32>]
   [-Scope <ClientAccessRulesScope>]
   [-UserIsMemberOf <MultiValuedProperty>]
   [-UsernameMatchesAnyOfPatterns <MultiValuedProperty>]
   [-UserRecipientFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Правила доступа клиентов похожи на правила потока обработки почты (также известные как правила транспорта) для клиентских подключений к вашей организации. Условия и исключения используются для определения подключений на основе их свойств и действий, разрешающих или блокирующих подключения.

Примечание. Не все протоколы поддерживают фильтры типов проверки подлинности, и даже протоколы, поддерживающие фильтры типов проверки подлинности, поддерживают не все типы проверки подлинности. Поддерживаемые сочетания описаны в следующих списках. Будьте осторожны при смешивании протоколов и типов проверки подлинности в одном правиле.

Протоколы, поддерживающие фильтры типов проверки подлинности:

  • ExchangeActiveSync: BasicAuthentication, OAuthAuthentication и CertificateBasedAuthentication.
  • ExchangeAdminCenter: BasicAuthentication и AdfsAuthentication.
  • IMAP4: BasicAuthentication и OAuthAuthentication.
  • OutlookWebApp: BasicAuthentication и AdfsAuthentication.
  • POP3: BasicAuthentication и OAuthAuthAuthentication.
  • RemotePowerShell: BasicAuthentication и NonBasicAuthentication.

Протоколы, не поддерживающие фильтры типов проверки подлинности:

  • ExchangeWebServices
  • OfflineAddressBook
  • OutlookAnywhere
  • PowerShellWebServices
  • REST
  • UniversalOutlook

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

Примеры

Пример 1

Set-ClientAccessRule "Allow IMAP4" -AnyOfClientIPAddressesOrRanges @{Add="172.17.17.27/16"}

В этом примере к существующему правилу клиентского доступа с именем "Allow IMAP4" добавляется диапазон IP-адресов 172.17.17.27/16, при этом существующие значения IP-адресов остаются без изменений.

Параметры

-Action

Параметр Action указывает действие для правила клиентского доступа. Допустимые значения этого параметра — AllowAccess и DenyAccess.

Тип:ClientAccessRulesAction
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AnyOfAuthenticationTypes

Этот параметр работает только в облачном сервисе.

Параметр AnyOfAuthenticationTypes указывает условие для правила клиентского доступа, основанное на типе проверки подлинности клиента.

Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

  • AdfsAuthentication
  • BasicAuthentication
  • CertificateBasedAuthentication
  • NonBasicAuthentication
  • OAuthAuthentication

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Примечание. См. раздел Описание, чтобы узнать, какие типы проверки подлинности можно использовать с какими протоколами.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection

-AnyOfClientIPAddressesOrRanges

Параметр AnyOfClientIPAddressesOrRanges указывает условие для правила доступа клиента, основанное на IPv4- или IPv6-адресе клиента. Допустимые значения:

  • Один IP-адрес: например, 192.168.1.1 или 2001:DB8:2AA:FF:C0A8:640A.
  • Диапазон IP-адресов: например, 192.168.0.1-192.168.0.254 или 2001:DB8:2AA:FF:C0A8:640A-2001:DB8:2AA:FF:C0A8:6414.
  • Диапазон IP-адресов бесклассовой междоменной маршрутизации (CIDR): например, 192.168.3.1/24 или 2001:DB8::2AA:FF:C0A8:640A/64.

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Дополнительные сведения об IPv6-адресах и синтаксисе см. в разделе Exchange 2013: IPv6-адреса основы.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AnyOfProtocols

Параметр AnyOfProtocols указывает условие для правила клиентского доступа, основанное на протоколе клиента.

Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

  • ExchangeActiveSync
  • ExchangeAdminCenter
  • ExchangeWebServices
  • IMAP4
  • OfflineAddressBook
  • OutlookAnywhere
  • OutlookWebApp
  • POP3
  • PowerShellWebServices
  • RemotePowerShell
  • REST
  • UniversalOutlook (приложение "Почта и календарь")

Примечание. В Exchange 2019 поддерживаются только Значения ExchangeAdminCenter и RemotePowerShell.

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AnyOfSourceTcpPortNumbers

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

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

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

Тип:Fqdn
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Параметр Enabled показывает, включено или нет правило клиентского доступа. Для этого параметра допускаются значения $true и $false.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExceptAnyOfAuthenticationTypes

Этот параметр работает только в облачном сервисе.

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

Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

  • AdfsAuthentication
  • BasicAuthentication
  • CertificateBasedAuthentication
  • NonBasicAuthentication
  • OAuthAuthentication

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Примечание. См. раздел Описание, чтобы узнать, какие типы проверки подлинности можно использовать с какими протоколами.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection

-ExceptAnyOfClientIPAddressesOrRanges

Параметр ExceptAnyOfClientIPAddressesOrRanges указывает исключение для правила доступа клиента, основанного на IPv4 или IPv6-адресе клиента. Допустимые значения:

  • Один IP-адрес: например, 192.168.1.1 или 2001:DB8:2AA:FF:C0A8:640A.
  • Диапазон IP-адресов: например, 192.168.0.1-192.168.0.254 или 2001:DB8:2AA:FF:C0A8:640A-2001:DB8:2AA:FF:C0A8:6414.
  • Диапазон IP-адресов бесклассовой междоменной маршрутизации (CIDR): например, 192.168.3.1/24 или 2001:DB8::2AA:FF:C0A8:640A/64.

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Дополнительные сведения об IPv6-адресах и синтаксисе см. в разделе Exchange 2013: IPv6-адреса основы.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExceptAnyOfProtocols

Этот параметр работает только в облачном сервисе.

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

Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

  • ExchangeActiveSync
  • ExchangeAdminCenter
  • ExchangeWebServices
  • IMAP4
  • OfflineAddressBook
  • OutlookAnywhere
  • OutlookWebApp
  • POP3
  • PowerShellWebServices
  • RemotePowerShell
  • REST
  • UniversalOutlook (приложение "Почта и календарь")

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection

-ExceptAnyOfSourceTcpPortNumbers

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013

-ExceptUserIsMemberOf

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013

-ExceptUsernameMatchesAnyOfPatterns

Этот параметр работает только в облачном сервисе.

Параметр ExceptUsernameMatchesAnyOfPatterns указывает исключение для правила доступа клиента, основанное на имени учетной записи пользователя в формате <Domain>\<UserName> (например, contoso.com\jeff). Этот параметр принимает текст и подстановочный знак (*) (например, *jeff*, но не jeff*). Escape-символы требуются только для последовательностей букв и цифр.

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

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

  • имя;
  • различающееся имя (DN);
  • GUID
Тип:ClientAccessRuleIdParameter
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Параметр Name указывает уникальное имя для правила клиентского доступа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Priority

Параметр Priority указывает приоритет для правила клиентского доступа. Меньшее целочисленное значение означает более высокий приоритет, а правило с высоким приоритетом имеет преимущество над правилом с меньшим приоритетом. Значение по умолчанию равно 1.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Scope

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

  • Users. Правило применяется только к подключениям пользователей.
  • All. Правило применяется ко всем подключениям (как от пользователей, так и от приложений среднего уровня).
Тип:ClientAccessRulesScope
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UserIsMemberOf

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013

-UsernameMatchesAnyOfPatterns

Этот параметр работает только в облачном сервисе.

Параметр UsernameMatchesAnyOfPatterns указывает условие для правила доступа клиента, основанное на имени учетной записи пользователя в формате <Domain>\<UserName> (например, contoso.com\jeff). Этот параметр принимает текст и подстановочный знак (*) (например, *jeff*, но не jeff*). Escape-символы требуются только для последовательностей букв и цифр.

Чтобы ввести несколько значений и перезаписать существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Тип:MultiValuedProperty
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UserRecipientFilter

Этот параметр работает только в облачном сервисе.

Параметр UserRecipientFilter задает условие для правила доступа клиента, которое использует синтаксис фильтра OPATH для идентификации пользователя на основе ограниченного набора свойств получателя. Правила доступа клиента не поддерживают полный список доступных свойств получателей.

С этим параметром можно использовать следующие свойства:

  • Город
  • Company
  • CountryOrRegion (код страны ISO 3166-1 alpha-2).
  • CustomAttribute1–CustomAttribute15
  • Отдел
  • Кабинет
  • PostalCode
  • StateOrProvince
  • StreetAddress

Базовый синтаксис для этого параметра:"Property -ComparisonOperator 'Value'"

  • Свойство является одним из фильтруемых свойств в приведенном выше списке (например, City или CustomAttribute1).
  • ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
  • Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).
  • Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.

Например:

  • "City -eq 'Redmond'"
  • "CountryOrRegion -eq 'SG'".

Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например:

  • "CustomAttribute1 -eq 'AllowOWA' -and CountryOrRegion -eq AU'"
  • "(CountryOrRegion -eq 'US' -and Department -eq 'Sales') -or Department -eq 'Research'".

Подробные сведения о синтаксисе фильтра OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

Input types

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

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

Output types

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