New-DlpKeywordDictionary

此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,参见 安全与合规中心 PowerShell

使用 New-DlpKeywordDictionary cmdlet 创建 DLP (关键字) 中的数据丢失Microsoft 365 合规中心。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

New-DlpKeywordDictionary
   -Name <String>
   [-Confirm]
   [-Description <String>]
   [-FileData <Byte[]>]
   [-WhatIf]
   [<CommonParameters>]

说明

创建指定 DLP 关键字词典的标识 (GUID 值) 的自定义敏感信息类型后,该词典将显示在敏感信息类型列表中,您可以在策略中使用它。

要在安全与合规中心 PowerShell 中使用此 cmdlet,必须分配权限。 有关详细信息,请参阅 Microsoft 365 合规中心中的权限

示例

示例 1

$Keywords = @("Aarskog's syndrome","Abandonment","Abasia","Abderhalden-Kaufmann-Lignac","Abdominalgia","Abduction contracture","Abetalipo proteinemia","Abiotrophy","Ablatio","ablation","Ablepharia","Abocclusion","Abolition","Aborter","Abortion","Abortus","Aboulomania","Abrami's disease","Abramo")
$EncodedKeywords = $Keywords | ForEach-Object {[System.Text.Encoding]::Unicode.GetBytes($_+"`r`n")}
New-DlpKeywordDictionary -Name "Diseases" -Description "Names of diseases and injuries from ICD-10-CM lexicon" -FileData $EncodedKeywords

此示例使用指定的值创建名为"一个子项"的 DLP 关键字词典。

示例 2

$Keywords = Get-Content "C:\My Documents\InappropriateTerms.txt"
$EncodedKeywords = $Keywords | ForEach-Object{[System.Text.Encoding]::Unicode.GetBytes($_+"`r`n")}
New-DlpKeywordDictionary -Name "Inappropriate Language" -Description "Unprofessional and inappropriate terminology" -FileData $EncodedKeywords

此示例从文件 C: My DocumentsInappropriateTerms.txt 创建名为"不恰当的语言"的 DLP \ \ 关键字InappropriateTerms.txt。 文件每行包含一个术语。

参数

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如,Remove-* cmdlet)内置有暂停,可强制要求你先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如,New-* and Set-*)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Description

Description 参数指定 DLP 关键字词典的描述性文本。 如果值包含空格,则使用引号括住该值。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-FileData

FileData 参数指定 DLP 关键字词典中使用的术语。 此参数需要以逗号分隔的值列表,这些值以 UTF-16 进行二进制编码。 有关详细信息,请参阅本主题中的示例。

Type:Byte[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Name

Name 参数指定 DLP 关键字词典的唯一名称。 如果值包含空格,则使用引号括住该值。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-WhatIf

WhatIf 开关在安全与合规中心 PowerShell 中不起作用。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center

输入

输出