共用方式為


Set-MailboxCalendarFolder

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Set-MailboxCalendarFolder Cmdlet 在信箱上設定行事曆發佈或共用設定,以向外部使用者顯示行事曆資訊。 若要新增或修改許可權,讓內部使用者可以存取行事曆,請使用Add-MailboxFolderPermission或Set-MailboxFolderPermission Cmdlet。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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

Description

Set-MailboxCalendarFolder Cmdlet 會設定行事曆發佈資訊。 行事曆資料夾的設定方式如下:

  • 是否啟用行事曆資料夾以進行發佈
  • 要發佈的開始和結束行事曆天數範圍
  • 要發佈行事曆的詳細資料層級
  • 是否啟用行事曆的已發佈 URL 以在網路上進行搜尋

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

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

本範例會將 Kai 共用行事曆的詳細資料層級設定為 LimitedDetails,這表示會顯示有限的詳細資料。

範例 2

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

此範例可讓 Kai 信箱中的行事曆可在 Web 上搜尋。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 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
  • 編輯者

只有在$true PublishEnabled 參數值時,這個參數才有意義。

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 參數會指定此 Cmdlet 用來向 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)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

此參數的範例值為 john@contoso.com:\CalendarJohn:\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

只有在$true PublishEnabled 參數值時,這個參數才有意義。

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

只有在$true PublishEnabled 參數值時,這個參數才有意義。

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 參數會指定是否可在 Web 上探索已發佈的行事曆 URL。

  • $true:可在 Web 上探索已發佈的行事曆 URL。
  • $false:網頁上無法探索已發佈的行事曆 URL。 這是預設值。

只有在$true PublishEnabled 參數值時,這個參數才有意義。

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 是委派信箱 (中共用行事曆的 FolderId, 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 參數會指定是否要針對行事曆資料夾的已發佈 URL 使用 HTTPS。 您不需要使用此參數指定值。

只有在$true PublishEnabled 參數值時,這個參數才有意義。

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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。