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


Set-MailboxCalendarFolder

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

Используйте командлет Set-MailboxCalendarFolder для настройки параметров публикации календаря и общего доступа к нему в почтовом ящике, чтобы сделать данные календаря видимыми для внешних пользователей. Добавлять или изменять разрешения на доступ внешних пользователей к календарю можно с помощью командлетов Add-MailboxFolderPermission или Set-MailboxFolderPermission.

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

Синтаксис

Set-MailboxCalendarFolder
   [-Identity] <MailboxFolderIdParameter>
   [-Confirm]
   [-DetailLevel <DetailLevelEnumType>]
   [-DomainController <Fqdn>]
   [-PublishDateRangeFrom <DateRangeEnumType>]
   [-PublishDateRangeTo <DateRangeEnumType>]
   [-PublishEnabled <Boolean>]
   [-ResetUrl]
   [-SearchableUrlEnabled <Boolean>]
   [-SetAsSharingSource]
   [-SharedCalendarSyncStartDate <DateTime>]
   [-UseHttps]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-MailboxCalendarFolder настраивает сведения о публикации календаря. Папка календаря может быть настроена следующим образом:

  • Включена ли в папке календаря служба публикации
  • Диапазон календарных дней начала и окончания для публикации
  • Уровень детализации публикации для календаря
  • Включен ли опубликованный URL-адрес календаря для поиска в Интернете

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

Примеры

Пример 1

Set-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetails

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

Пример 2

Set-MailboxCalendarFolder -Identity kai:\Calendar -SearchableUrlEnabled $true

В этом примере календарь в почтовом ящике Григория становится доступным для поиска в Интернете.

Параметры

-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

-DetailLevel

Параметр DetailLevel указывает уровень детализации календаря, опубликованного и доступного для анонимных пользователей. Допустимые значения:

  • AvailabilityOnly (это значение по умолчанию)
  • LimitedDetails
  • FullDetails
  • Редактор

Этот параметр имеет смысл, только если значение параметра PublishEnabled $true.

Type:DetailLevelEnumType
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

-Identity

Параметр Identity указывает папку календаря, которую требуется изменить. Используется следующий синтаксис: MailboxID:\ParentFolder[\SubFolder].

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Примеры значений для этого параметра: john@contoso.com:\Calendar или John:\Calendar

Type:MailboxFolderIdParameter
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

-PublishDateRangeFrom

Параметр PublishDateRangeFrom указывает дату начала публикации сведений календаря (прошлых сведений). Допустимые значения:

  • OneDay
  • ThreeDays
  • OneWeek
  • OneMonth
  • ThreeMonths (это значение по умолчанию)
  • SixMonths
  • OneYear

Этот параметр имеет смысл, только если значение параметра PublishEnabled $true.

Type:DateRangeEnumType
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

-PublishDateRangeTo

Параметр PublishDateRangeTo указывает дату окончания публикуемых сведений календаря (будущих сведений). Допустимые значения:

  • OneDay
  • ThreeDays
  • OneWeek
  • OneMonth
  • ThreeMonths (это значение по умолчанию)
  • SixMonths
  • OneYear

Этот параметр имеет смысл, только если значение параметра PublishEnabled $true.

Type:DateRangeEnumType
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

-PublishEnabled

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

  • $true. Сведения о календаре публикуются.
  • $false: сведения о календаре не публикуются. Это значение используется по умолчанию.
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

-ResetUrl

Параметр ResetUrl заменяет существующий недоступный URL-адрес новым URL-адресом календаря, который был опубликован без общедоступного поиска. Для этого переключателя не требуется указывать значение.

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

-SearchableUrlEnabled

Параметр SearchableUrlEnabled указывает, можно ли обнаружить опубликованный URL-адрес календаря в Интернете.

  • $true: URL-адрес опубликованного календаря можно найти в Интернете.
  • $false: URL-адрес опубликованного календаря не обнаруживается в Интернете. Это значение используется по умолчанию.

Этот параметр имеет смысл, только если значение параметра PublishEnabled $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

-SetAsSharingSource

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

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

-SharedCalendarSyncStartDate

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

Примечание. Этот параметр поддерживается только для общих календарей, которые были обновлены, как описано в разделе Общий доступ к календарям в Microsoft 365, и неприменим ни к одному другому типу календаря или папки почтового ящика.

Параметр SharedCalendarSyncStartDate задает ограничение для прошлых событий в общем календаре, видимых делегатам. Копия общего календаря в указанном диапазоне дат хранится в почтовом ящике делегата.

Чтобы указать значение даты или времени для этого параметра, воспользуйтесь одним из следующих вариантов:

  • Укажите значение даты и времени в формате UTC. Например, "2021-05-06 14:30:00z".
  • Укажите значение даты и времени в виде формулы, которая преобразует дату и время в местном часовом поясе в utc: например, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Для получения дополнительной информации см. Get-Date.

Примечания.

  • Этот параметр используется в общем календаре в почтовом ящике делегата. Например, Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId — это Идентификатор папки общего календаря в почтовом ящике делегата (например, Get-MailboxFolderStatistics -Identity delegate@contoso.onmicrosoft.com -FolderScope Calendar | Format-List Name,FolderId).
  • Пользователям требуется доступ FullDetails, Редактор или Делегирование доступа к указанному общему календарю.
  • Установка этого параметра может привести к тому, что события в общем календаре ненадолго исчезнут из представления во время повторной синхронизации календаря.
  • Значение этого параметра используется при инициализации синхронизации папок календаря. После этого каждый новый, обновленный и удаленный элемент обрабатывается и синхронизируется независимо от значения параметра SharedCalendarSyncStartDate.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseHttps

Параметр UseHttps указывает, следует ли использовать HTTPS для опубликованного URL-адреса папки календаря. Указывать значение для этого параметра необязательно.

Этот параметр имеет смысл только в том случае, если значение параметра PublishEnabled $true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

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