Set-RetentionCompliancePolicy
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊,請參閱 安全性與合規性 PowerShell。
使用 Set-RetentionCompliancePolicy Cmdlet 修改Microsoft Purview 合規性入口網站中現有的保留原則。
注意:執行此 Cmdlet 會導致整個組織的完整同步處理,這是一項重大作業。 如果您需要更新多個原則,請等到原則發佈成功後,再針對下一個原則再次執行 Cmdlet。 如需發佈狀態的相關資訊,請參閱 Get-RetentionCompliancePolicy。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Identity
Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-AddOneDriveLocation <MultiValuedProperty>]
[-AddOneDriveLocationException <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-AddSharePointLocationException <MultiValuedProperty>]
[-AddSkypeLocation <MultiValuedProperty>]
[-AddSkypeLocationException <MultiValuedProperty>]
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PolicyTemplateInfo <PswsHashtable>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PriorityCleanup]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RemoveOneDriveLocation <MultiValuedProperty>]
[-RemoveOneDriveLocationException <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-RemoveSharePointLocationException <MultiValuedProperty>]
[-RemoveSkypeLocation <MultiValuedProperty>]
[-RemoveSkypeLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>]
AdaptiveScopeLocation
Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PriorityCleanup]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>]
RetryDistribution
Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-DeletedResources <String>]
[-EnforceSimulationPolicy <Boolean>]
[-PriorityCleanup]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>]
TeamLocation
Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddTeamsChannelLocation <MultiValuedProperty>]
[-AddTeamsChannelLocationException <MultiValuedProperty>]
[-AddTeamsChatLocation <MultiValuedProperty>]
[-AddTeamsChatLocationException <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PriorityCleanup]
[-RemoveTeamsChannelLocation <MultiValuedProperty>]
[-RemoveTeamsChannelLocationException <MultiValuedProperty>]
[-RemoveTeamsChatLocation <MultiValuedProperty>]
[-RemoveTeamsChatLocationException <MultiValuedProperty>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
若要在安全性與合規性 PowerShell 中使用此 Cmdlet,您必須獲得指派權限。 如需詳細資訊,請參閱 Microsoft Purview 合規性入口網站中的權限。
註: 請勿在加入或移除範圍位置時使用管道 Foreach-Object 命令: "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}。
範例
範例 1
Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"
本範例會對名為 "Regulation 123 Compliance" 的現有保留原則進行下列變更:
- 新增名為 Kitty Petersen 的使用者的信箱。
- 新增 SharePoint 網站
https://contoso.sharepoint.com/sites/teams/finance。 - 移除公用資料夾。
- 更新註解。
範例 2
$stringJson = @"
[{
'EmailAddress': 'USSales@contoso.onmicrosoft.com',
'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson
此範例會從指定的原則中移除指定已刪除的 Microsoft 365 群組和網站。 您可以使用 Microsoft 365 群組電子郵件地址和相關網站識別碼來識別已刪除的資源。
重要: 在執行此命令之前,請務必閱讀有關重複 SMTP 位址的 DeletedResources 參數 警告資訊。
範例 3
$stringJson = @"
[{
'EmailAddress': 'USSales@contoso.onmicrosoft.com',
'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson
此範例會從指定的租用戶層級原則中排除指定已刪除的 Microsoft 365 群組和網站。 您可以使用 Microsoft 365 群組電子郵件地址和相關網站識別碼來識別已刪除的資源。
重要: 在執行此命令之前,請務必閱讀有關重複 SMTP 位址的 DeletedResources 參數 警告資訊。
範例 4
$stringJson = @"
[{
'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
},
{
'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson
此範例與範例 2 類似,但指定了多個已刪除的資源。
重要: 在執行此命令之前,請務必閱讀有關重複 SMTP 位址的 DeletedResources 參數 警告資訊。
範例 5
$stringJson = @"
[{
'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@
Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson
本範例會從上述的 Teams 保留原則中排除指定的虛刪除信箱或郵件使用者。 您可以使用信箱或郵件使用者的電子郵件地址來識別已刪除的資源。
重要: 在執行此命令之前,請務必閱讀有關重複 SMTP 位址的 DeletedResources 參數 警告資訊。
範例 6
$stringJson = @"
[{
'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@
Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson
此範例與範例 5 類似,但指定了多個已刪除的資源。
重要: 在執行此命令之前,請務必閱讀有關重複 SMTP 位址的 DeletedResources 參數 警告資訊。
原則排除必須保持在保留原則支援的限制內: Microsoft 365 保留原則和保留標籤原則的限制
參數
-AddAdaptiveScopeLocation
適用對象:安全性 & 合規性
AddAdaptiveScopeLocation 參數會指定要新增至原則的調適性範圍位置。 您可以使用 New-AdaptiveScope Cmdlet 建立調適性範圍。 您可以使用唯一識別調適性範圍的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AdaptiveScopeLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddExchangeLocation
適用對象:安全性 & 合規性
AddExchangeLocation 參數會指定當您未針對 ExchangeLocation 參數使用值 [全部] 時,要新增至所包含信箱清單的信箱。 有效值為:
- ExchangeLocation 參數會指定要包含在原則中的信箱。有效值為:
- 信箱
所有信箱的 All 值。 您只能使用這個值本身。
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddExchangeLocationException
適用對象:安全性 & 合規性
當您針對 ExchangeLocation 參數使用值 All 時,此參數會指定要新增至排除信箱清單的信箱。 有效值為:
- 當您針對 ExchangeLocation 參數使用 All 值時,此參數會指定要從排除信箱清單中移除的信箱。有效值為:
- 信箱
所有信箱的 All 值。 您只能使用這個值本身。
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddModernGroupLocation
適用對象:安全性 & 合規性
AddModernGroupLocation 參數會指定當您未針對 ModernGroupLocation 參數使用 [全部] 值時要新增至所包含Microsoft 365 群組清單的Microsoft 365 群組。
您可以使用唯一識別 Microsoft 365 群組的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddModernGroupLocationException
適用對象:安全性 & 合規性
AddModernGroupLocationException 參數會指定當您針對 ModernGroupLocation 參數使用值 All 時,要新增至排除的 Microsoft 365 群組清單的 Microsoft 365 群組。
您可以使用唯一識別 Microsoft 365 群組的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddOneDriveLocation
適用對象:安全性 & 合規性
AddOneDriveLocation 參數會指定當您未針對 OneDriveLocation 參數使用「全部」值時,要新增至包含網站清單的 OneDrive 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddOneDriveLocationException
適用對象:安全性 & 合規性
當您針對 OneDriveLocation 參數使用值 All 時,此參數會指定要新增至排除網站清單的 OneDrive 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddPublicFolderLocation
適用對象:安全性 & 合規性
AddPublicFolderLocation 參數會指定您要將所有公用資料夾新增至保留原則。 您可對此參數使用 All 值。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddSharePointLocation
適用對象:安全性 & 合規性
AddSharePointLocation 參數會指定當您未針對 SharePointLocation 參數使用「全部」值時,要新增至包含網站清單的 SharePoint 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
在編製索引之前,無法將 SharePoint 網站新增到原則中。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddSharePointLocationException
適用對象:安全性 & 合規性
當您針對 SharePointLocation 參數使用值 [全部] 時,此參數會指定要新增至排除網站清單的 SharePoint 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddSkypeLocation
適用對象:安全性 & 合規性
AddSkypeLocation 參數會指定要從包含的商務用 Skype Online 使用者清單中新增的商務商務用 Skype Online 使用者。
您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddSkypeLocationException
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddTeamsChannelLocation
適用對象:安全性 & 合規性
AddTeamsChannelLocation 參數會指定要新增至原則的團隊。
您可以使用唯一識別團隊的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddTeamsChannelLocationException
適用對象:安全性 & 合規性
AddTeamsChannelLocationException 參數會指定當您針對 TeamsChannelLocation 參數使用 [全部] 值時要新增至排除清單的團隊。 您可以使用唯一識別團隊的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddTeamsChatLocation
適用對象:安全性 & 合規性
AddTeamsChatLocation 參數會指定要新增至原則的 Teams 使用者。
您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AddTeamsChatLocationException
適用對象:安全性 & 合規性
AddTeamsChatLocationException 參數會指定當您針對 TeamsChatLocation 參數使用值「全部」時,要新增至排除清單的 Teams 使用者。 您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Applications
適用對象:安全性 & 合規性
Applications 參數會指定將Microsoft 365 群組包含在原則中 (ModernGroups 參數設定) 時的目標。 有效值為:
-
Group:Exchange連線到 Microsoft 365 群組的信箱。 -
Group:SharePoint連線至 Microsoft 365 群組的 SharePoint 網站。 -
"Group:Exchange,SharePoint"針對連線到 Microsoft 365 群組的信箱和 SharePoint 網站。 - 空白 (
$null) :此值為預設值,功能上相當於值"Group:Exchange,SharePoint"。 若要回到所選 Microsoft 365 群組的信箱和 SharePoint 網站的預設值,請指定"Group:Exchange,SharePoint"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Comment
適用對象:安全性 & 合規性
Comment 參數會指定選擇性註解。 如果指定的值含有空格,則必須以雙引號 (") 括住值,例如︰"This is an admin note"。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用對象:安全性 & 合規性
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 |
-DeletedResources
適用對象:安全性 & 合規性
DeletedResources 參數會指定要移除或新增到個別位置清單的排除項目,或新增到已刪除的 Microsoft 365 群組、信箱或郵件使用者。 將此參數與已刪除的 Microsoft 365 群組的 AddModernGroupLocationException 和 RemoveModernGroupLocation 參數搭配使用,或針對已刪除的信箱或郵件使用者與 AddTeamsChatLocationException 參數搭配使用。
有效的值是 JSON 字串。 如需此參數的語法和使用範例,請參閱範例一節。
注意:當您使用 SMTP 位址和此參數時,請注意相同的位址可能也會用於其他信箱或郵件使用者。 若要檢查具有相同 SMTP 位址的其他信箱或郵件使用者,請使用下列命令,並以 user@contoso.com SMTP 位址取代以進行檢查: Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted
若要防止排除具有相同 SMTP 位址的作用中信箱或郵件使用者,請在執行具有 DeletedResources 參數的命令之前,先將信箱置於 訴訟保留 狀態。
如需已刪除 Microsoft 365 群組案例的詳細資訊,請參閱 深入了解保留保留情況下的新式群組刪除。
如需非作用中信箱案例的詳細資訊,請參閱 瞭解非作用中信箱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Enabled
適用對象:安全性 & 合規性
Enabled 參數會指定是否已啟用原則。 有效值為:
- $true:已啟用原則。 此值為預設值。
- $true:已啟用原則。此為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EnforceSimulationPolicy
適用對象:安全性 & 合規性
EnforceSimulationPolicy 參數會指定是否要將模擬原則強制執行為作用中原則。 有效值為:
- $true:將模擬原則強制執行為作用中原則。
- $false:不要將模擬原則強制執行為作用中原則。 此值為預設值。
如需模擬模式的詳細資訊,請參閲 了解模擬模式。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用對象:安全性 & 合規性
強制開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中,您可以使用此參數來利用程式設計方式執行工作。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用對象:安全性 & 合規性
Identity 參數會指定您要修改的保留原則。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | PolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PolicyRBACScopes
適用對象:安全性 & 合規性
注意:目前不支援管理員單位,因此此參數無法運作。 此處所提供的資訊僅供參考,以在發行管理單位支援時之用。
PolicyRBACScopes 參數會指定要指派給原則的管理單位。 有效的值是管理單位的 Microsoft Entra ObjectID (GUID 值) 。 您可以指定多個以逗號分隔的值。
系統管理單位僅適用於 Microsoft Entra ID P1 或 P2。 您會在 Microsoft Graph PowerShell 中建立和管理管理單位。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PolicyTemplateInfo
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | PswsHashtable |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PriorityCleanup
適用對象:安全性 & 合規性
PriorityCleanup 參數可指定是否要更新優先順序清除原則。 您不需要使用此參數指定值。
優先順序清除原則可覆寫任何現有的保留設定或電子文件探索保留,以加速刪除敏感性內容。 如需詳細資訊,請參閱 優先清除。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveAdaptiveScopeLocation
適用對象:安全性 & 合規性
RemoveAdaptiveScopeLocation 參數會指定要從原則中移除的調適性範圍位置。 您可以使用 New-AdaptiveScope Cmdlet 建立調適性範圍。 您可以使用唯一識別調適性範圍的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AdaptiveScopeLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveExchangeLocation
適用對象:安全性 & 合規性
RemoveExchangeLocation 參數會指定當您未針對 ExchangeLocation 參數使用 [全部] 值時,要從包含的信箱清單中移除的信箱。
您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveExchangeLocationException
適用對象:安全性 & 合規性
RemoveExchangeLocationException 參數會指定當您針對 ExchangeLocation 參數使用值 All 時,要從排除的信箱清單中移除的信箱。
您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveModernGroupLocation
適用對象:安全性 & 合規性
RemoveModernGroupLocation 參數會指定當您未針對 ModernGroupLocation 參數使用 [全部] 值時,要從包含的群組清單中移除的 Microsoft 365 群組。
您可以使用唯一識別 Microsoft 365 群組的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveModernGroupLocationException
適用對象:安全性 & 合規性
RemoveModernGroupLocationException 參數會指定當您為 ModernGroupLocation 參數使用值 All 時,要從排除的群組清單中移除的 Microsoft 365 群組。
您可以使用唯一識別 Microsoft 365 群組的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveOneDriveLocation
適用對象:安全性 & 合規性
RemoveOneDriveLocation 參數會指定當您未針對 OneDriveLocation 參數使用「全部」值時,要從包含網站清單中移除的 OneDrive 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveOneDriveLocationException
適用對象:安全性 & 合規性
當您對 OneDriveLocation 參數使用值 All 時,此參數會指定要從排除網站清單中移除的 OneDrive 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemovePublicFolderLocation
適用對象:安全性 & 合規性
RemovePublicFolderLocation 參數會指定您要從保留原則中移除所有的公用資料夾。 您可對此參數使用 All 值。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveSharePointLocation
適用對象:安全性 & 合規性
RemoveSharePointLocation 參數會指定當您未針對 SharePointLocation 參數使用「全部」值時,要從包含網站清單中移除的 SharePoint 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveSharePointLocationException
適用對象:安全性 & 合規性
當您對 SharePointLocation 參數使用值 All 時,此參數會指定要從排除網站清單中移除的 SharePoint 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveSkypeLocation
適用對象:安全性 & 合規性
RemoveSkypeLocation 參數會指定要從包含的商務用 Skype Online 使用者清單中移除的商務商務用 Skype Online 使用者。
您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveSkypeLocationException
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveTeamsChannelLocation
適用對象:安全性 & 合規性
RemoveTeamsChannelLocation 參數會指定要從原則中移除的團隊。
您可以使用唯一識別團隊的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveTeamsChannelLocationException
適用對象:安全性 & 合規性
RemoveTeamsChannelLocationException 參數會指定當您針對 TeamsChannelLocation 參數使用值 [全部] 時要從排除清單中移除的團隊。 您可以使用唯一識別團隊的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveTeamsChatLocation
適用對象:安全性 & 合規性
RemoveTeamsChatLocation 參數會指定要從原則中移除的 Teams 使用者。
您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveTeamsChatLocationException
適用對象:安全性 & 合規性
RemoveTeamsChatLocationException 參數會指定當您針對 TeamsChatLocation 參數使用值 [全部] 時,要從排除清單中移除的 Teams 使用者。 您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 電子郵件地址
- GUID
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TeamLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RestrictiveRetention
適用對象:安全性 & 合規性
RestrictiveRetention 參數會指定是否要為保留原則或保留標籤原則啟用保留鎖定。 有效值為:
- $true:已為原則啟用保留鎖定。 沒有人 (包括系統管理員) 可以關閉原則或降低其限制。
- $false:未為原則啟用保留鎖定。 此值為預設值。
鎖定原則之後,任何人都無法關閉或停用它,或從原則中移除內容。 且在保留期間,無法修改或刪除受原則約束的內容。 修改保留原則的唯一方式是在其中新增內容,或延長其持續時間。 鎖定原則可以增加或延長,但無法減少、停用或關閉。
因此,在鎖定保留原則之前,請務必瞭解組織的合規性需求,並且在確定這是您需要的原則之前不要鎖定原則。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RetryDistribution
適用對象:安全性 & 合規性
RetryDistribution 參數會指定是否要將原則重新發佈到所有 Exchange Online 和 SharePoint 位置。 您不需要使用此參數指定值。
初始配送成功的位置不包含在重試中。 當您使用此參數時會回報原則配送錯誤。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RetryDistribution
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StartSimulation
適用對象:安全性 & 合規性
StartSimulation 參數會指定是否要為在模擬模式中建立的原則啟動模擬。 有效值為:
- $true:開始模擬。
- $false:請勿啟動模擬。 此值為預設值。
如需模擬模式的詳細資訊,請參閲 了解模擬模式。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用對象:安全性 & 合規性
WhatIf 開關無法在安全性與合規性 PowerShell 中使用。
參數屬性
| 類型: | 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。