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。