Set-SharingPolicy
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Командлет Set-SharingPolicy используется для изменения существующих политик общего доступа, контролирующих обмен сведениями о занятости и контактными данными между пользователями внутри организации и вне ее.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-SharingPolicy
[-Identity] <SharingPolicyIdParameter>
[-Confirm]
[-Default]
[-DomainController <Fqdn>]
[-Domains <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Пользователи могут обмениваться данными о доступности и контакте только после настройки федерации между организациями Exchange. После этого пользователи могут отправлять внешним получателям приглашения к совместному использованию, если эти приглашения соответствуют политике общего доступа. Чтобы применить политику общего доступа, необходимо назначить ее для почтового ящика. Если почтовому ящику не назначена определенная политика общего доступа, политика по умолчанию принудительно применяет параметры общего доступа для почтового ящика.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-SharingPolicy -Identity Contoso -Domains "mail.contoso.com: CalendarSharingFreeBusySimple"
В этом примере имя политики общего доступа Contoso изменяется на contoso.com, которое принадлежит внешнему домену. Эта политика позволяет пользователям домена Contoso просматривать сведения о занятости.
Пример 2
Set-SharingPolicy -Identity SharingPolicy01 -Domains "contoso.com: CalendarSharingFreeBusySimple", "atlanta.contoso.com: CalendarSharingFreeBusyReviewer", "beijing.contoso.com: CalendarSharingFreeBusyReviewer"
В этом примере второй домен добавляется к политике общего доступа SharingPolicy01. При добавлении домена к существующей политике необходимо включить в нее все ранее включенные домены.
Пример 3
Set-SharingPolicy -Identity "SharingPolicy01" -Enabled $false
В этом примере отключается политика общего доступа SharingPolicy01.
Параметры
-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 |
-Default
Параметр Default указывает, что эта политика общего доступа является политикой по умолчанию для всех почтовых ящиков. Указывать значение для этого параметра необязательно.
Если для почтового ящика не назначена политика общего доступа, к нему автоматически применяется политика по умолчанию. Если вы хотите отключить возможность предоставления общего доступа по всей организации, отключите политику по умолчанию.
Type: | SwitchParameter |
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 |
-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 |
-Domains
Параметр Domains указывает домены и связанные параметры общего доступа для этих доменов в политике общего доступа. Значения для этого параметра используют базовый синтаксис: 'Domain: SharingPolicyAction'
.
Для можно использовать следующие значения Domain
:
- Домен: например,
mail.contoso.com
. Домен не включает в себя дочерние домены. Каждый дочерний домен настраивается отдельно. - *: предоставление общего доступа внешним федеративных организаций. Например, другая организация Майкрософт 365 или локальную организацию Exchange.
- Анонимная. Предоставление общего доступа внешним, не федеративным организациям и пользователям с доступом в Интернет.
Для можно использовать следующие значения SharingPolicyAction
:
- CalendarSharingFreeBusySimple: общий доступ только к часам доступности
- CalendarSharingFreeBusyDetail: совместное использование свободных и занятых часов, темы и расположения
- CalendarSharingFreeBusyReviewer: общий доступ к часам занятости, теме, расположению и тексту сообщения или элемента календаря
- Контакты Совместное использование: общий доступ только к контактам
Можно указать несколько 'Domain: SharingPolicyAction'
значений, разделенных запятыми, и указать несколько SharingPolicyAction
значений для одного домена, разделенных запятыми. Например, 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'
.
Type: | MultiValuedProperty |
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 |
-Enabled
Параметр Enabled указывает, включена ли политика общего доступа. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $true.
Если политика общего доступа отключена, пользователи, которым разрешено использовать эту политику, могут продолжить обмениваться данными, пока работает помощник политики общего доступа.
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, Exchange Online |
-Identity
Параметр Identity указывает идентификатор политики общего доступа, который необходимо изменить. Можно использовать одно из следующих значений:
- ADObjectID
- Различающееся имя (DN)
- Устаревшее различающееся имя
- GUID
Type: | SharingPolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Параметр Name указывает уникальное имя политики общего доступа. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Type: | String |
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 |
-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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.