New-SensitiveInformationScan
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊,請參閱 安全性與合規性 PowerShell。
使用 New-SensitiveInformationScan Cmdlet 來建立新的隨選分類掃描。 若要深入了解隨選分類,請參閱隨 選分類。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
New-SensitiveInformationScan
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-EndpointDlpLocation <MultiValuedProperty>]
[-EndpointDlpLocationException <MultiValuedProperty>]
[-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
[-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeSender <SmtpAddress[]>]
[-ExchangeSenderException <SmtpAddress[]>]
[-ExchangeSenderMemberOf <RecipientIdParameter[]>]
[-ExchangeSenderMemberOfException <RecipientIdParameter[]>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-OneDriveSharedBy <RecipientIdParameter[]>]
[-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-TeamsLocation <MultiValuedProperty>]
[-TeamsLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
若要在安全性與合規性 PowerShell 中使用此 Cmdlet,您必須獲得指派權限。 如需詳細資訊,請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
New-SensitiveInformationScan "SharePoint scan" -SharePointLocation All
New-SensitiveInformationScanRule "SharePoint scan rule" -ContentExtensionMatchesWords "pdf", "docx" -Policy "SharePoint scan" -Workload SharePoint
此範例會為僅限 pdf 和 docx 檔案的所有 SharePoint 網站建立掃描。
參數
-Comment
適用對象:安全性 & 合規性
Comment 參數會指定選擇性註解。 如果指定的值含有空格,則必須以雙引號 (") 括住值,例如︰"This is an admin note"。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 |
-EndpointDlpLocation
適用對象:安全性 & 合規性
注意: 此參數需要 Microsoft Entra ID 中合規性系統管理員或合規性資料系統管理員角色的成員資格。
EndpointDLPLocation 參數會指定要包含在裝置掃描中的使用者帳戶。 您可以透過名稱或電子郵件地址識別帳戶。 您可以使用值 All 來包含所有使用者帳戶。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
如需將裝置上線至 Purview 的詳細資訊,請參閱 瞭解裝置上線) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EndpointDlpLocationException
適用對象:安全性 & 合規性
注意: 此參數需要 Microsoft Entra ID 中合規性系統管理員或合規性資料系統管理員角色的成員資格。
EndpointDlpLocationException 參數會指定要在裝置的隨選分類掃描中排除的使用者帳戶。 您可以透過名稱或電子郵件地址識別帳戶。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
如需將裝置上線至 Purview 的詳細資訊,請參閱 瞭解裝置上線) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExceptIfOneDriveSharedBy
適用對象:安全性 & 合規性
ExceptIfOneDriveSharedBy 參數會指定要從掃描中排除的使用者, (掃描) 包括 OneDrive 使用者帳戶的網站。 您可以根據 UPN (laura@contoso.onmicrosoft.com) 來識別使用者。
若要使用此參數,掃描中必須包含 OneDrive 網站, (OneDriveLocation 參數值為 All,這是預設值) 。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
您無法將此參數與 OneDriveSharedBy 或 OneDriveSharedByMemberOf 參數搭配使用。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExceptIfOneDriveSharedByMemberOf
適用對象:安全性 & 合規性
ExceptIfOneDriveSharedByMemberOf 參數會指定要從掃描中排除的通訊群組或啟用郵件功能的安全性群組, (從掃描) 排除群組成員的 OneDrive 網站。 您可以依電子郵件地址識別群組。
若要使用此參數,掃描中必須包含 OneDrive 網站, (OneDriveLocation 參數值為 All,這是預設值) 。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
您無法將此參數與 OneDriveSharedBy 或 OneDriveSharedByMemberOf 參數搭配使用。
您無法使用此參數來指定 Microsoft 365 群組。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeLocation
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeSender
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SmtpAddress[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeSenderException
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SmtpAddress[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeSenderMemberOf
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeSenderMemberOfException
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用對象:安全性 & 合規性
Name 參數會指定掃描的唯一名稱。 如果值包含空格,請使用引號括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OneDriveLocation
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OneDriveLocationException
適用對象:安全性 & 合規性
當您針對 OneDriveLocation 參數使用值 All 時,此參數會指定要排除的 OneDrive 網站。 您可以依據其 URL 值識別網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OneDriveSharedBy
適用對象:安全性 & 合規性
OneDriveSharedBy 參數會指定掃描中要包括的使用者, (掃描) 包括 OneDrive 使用者帳戶的網站。 您可以根據 UPN (laura@contoso.onmicrosoft.com) 來識別使用者。
若要使用此參數,掃描中必須包含 OneDrive 網站, (OneDriveLocation 參數值為 All,這是預設值) 。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
您無法將此參數與 ExceptIfOneDriveSharedBy 或 ExceptIfOneDriveSharedByMemberOf 參數搭配使用。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OneDriveSharedByMemberOf
適用對象:安全性 & 合規性
OneDriveSharedByMemberOf 參數會指定掃描中要包括的通訊群組或啟用郵件功能的安全性群組, (掃描) 包括群組成員的 OneDrive 網站。 您可以依電子郵件地址識別群組。
若要使用此參數,掃描中必須包含 OneDrive 網站, (OneDriveLocation 參數值為 All,這是預設值) 。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
您無法將此參數與 ExceptIfOneDriveSharedBy 或 ExceptIfOneDriveSharedByMemberOf 參數搭配使用。
您無法使用此參數來指定 Microsoft 365 群組。
參數屬性
| 類型: | RecipientIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PolicyRBACScopes
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharePointLocation
適用對象:安全性 & 合規性
SharePointLocation 參數會指定要包含在掃描中的 SharePoint 網站。 您依據其 URL 值識別網站,或者您可以使用 All 值以包含所有網站。
在對 SharePoint 網站編製索引之前,您無法將網站新增到原則。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharePointLocationException
適用對象:安全性 & 合規性
SharePointLocationException 參數會指定當您針對 SharePointLocation 參數使用值 All 時要排除的 SharePoint 網站。 您可以依據其 URL 值識別網站。
在對 SharePoint 網站編製索引之前,您無法將 SharePoint 網站新增到掃描。
若要輸入多個值,請使用下列語法: <value1>,<value2>,...<valueX>。 如果這些值包含空格或需要引號,請使用下列語法: "<value1>","<value2>",..."<valueX>"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TeamsLocation
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TeamsLocationException
適用對象:安全性 & 合規性
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | 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。