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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по