Set-MailboxCalendarFolder
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-MailboxCalendarFolder Cmdlet 在信箱上設定行事曆發佈或共用設定,讓外部使用者可以看到行事曆資訊。 若要新增或修改權限,讓內部使用者可以存取行事曆,請使用 Add-MailboxFolderPermission 或 Set-MailboxFolderPermission Cmdlet。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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
此範例可讓 Kai 信箱中的行事曆可在網頁上搜尋。
參數
-Confirm
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DetailLevel
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
DetailLevel 參數會指定已發佈且可供匿名使用者使用的行事曆詳細資料層級。 有效值為:
- AvailabilityOnly (預設)
- LimitedDetails
- 完整詳細資料
只有當 PublishEnabled 參數值為$true時,此參數才有意義。
參數屬性
| 類型: | DetailLevelEnumType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
Identity 參數會指定您要修改的行事曆資料夾。 語法為 MailboxID:\ParentFolder[\SubFolder]。
針對 的 MailboxID值,您可以使用唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
此參數的範例值如下 john@contoso.com:\Calendar 或 John:\Calendar
參數屬性
| 類型: | MailboxFolderIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PublishDateRangeFrom
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
PublishDateRangeFrom 參數會指定行事曆資訊的開始日期,以發佈 (過去的資訊) 。 有效值為:
- OneDay
- ThreeDays
- OneWeek
- OneMonth
- ThreeMonths (預設值)
- SixMonths
- 一年
只有當 PublishEnabled 參數值為$true時,此參數才有意義。
參數屬性
| 類型: | DateRangeEnumType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PublishDateRangeTo
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
PublishDateRangeTo 參數會指定行事曆資訊的結束日期,以發佈 (未來資訊) 。 有效值為:
- OneDay
- ThreeDays
- OneWeek
- OneMonth
- ThreeMonths (預設值)
- SixMonths
- 一年
只有當 PublishEnabled 參數值為$true時,此參數才有意義。
參數屬性
| 類型: | DateRangeEnumType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PublishEnabled
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
PublishEnabled 參數會指定是否要發佈指定的行事曆資訊。 有效值為:
- $true:已發佈行事曆資訊。
- $false:不會發佈行事曆資訊。 此值為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResetUrl
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResetUrl 參數會將現有的非公開 URL 取代為已發佈而無法公開搜尋之行事曆的新 URL。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SearchableUrlEnabled
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SearchableUrlEnabled 參數指定發佈的行事曆 URL 是否可在網頁上探索。
- $true:已發佈的行事曆 URL 可在網頁上探索。
- $false:無法在網路上探索已發佈的行事曆 URL。 此值為預設值。
只有當 PublishEnabled 參數值為$true時,此參數才有意義。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SetAsSharingSource
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SetAsSharingSource 參數會指定是否要將行事曆資料夾設定為共用來源。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharedCalendarSyncStartDate
適用:Exchange Online
此參數只能在雲端式服務中使用。
附註:只有已如 Microsoft 365 中的Calendar共用所述升級的共用行事曆支援此參數,且不適用於任何其他類型的行事曆或信箱資料夾。
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、Editor 或 Delegate 存取權。
- 設定此參數可能會導致共用行事曆中的活動在行事曆重新同步處理時短暫地從檢視中消失。
- 這個參數的值會在初始化行事曆資料夾同步處理時使用。之後,無論 SharedCalendarSyncStartDate 參數值為何,都會處理並同步處理每個新增、更新及刪除的項目。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseHttps
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
UseHttps 參數會指定是否要針對行事曆資料夾的已發佈 URL 使用 HTTPS。 您不需要使用此參數指定值。
只有當 PublishEnabled 參數值為$true時,此參數才有意義。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。