你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AipServiceTemplateProperty

获取 Azure 信息保护的保护模板的属性。

语法

Get-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names]
   [-Descriptions]
   [-RightsDefinitions]
   [-ContentExpirationOption]
   [-ContentExpirationDate]
   [-ContentValidityDuration]
   [-LicenseValidityDuration]
   [-ReadOnly]
   [-Status]
   [-ScopedIdentities]
   [-EnableInLegacyApps]
   [<CommonParameters>]

说明

Get-AipServiceTemplateProperty cmdlet 使用 TemplateId 参数获取 Azure 信息保护保护模板的指定属性。

也可以在Azure 门户中查看类似的配置信息,但此 cmdlet 还包括模板 GUID。

可以查询默认模板的属性或自定义模板。 有关自定义模板的详细信息,包括如何在Azure 门户中配置它们,请参阅配置和管理 Azure 信息保护的模板

使用 Azure 信息保护统一标记客户端?

Azure 信息保护统一标记客户端间接使用保护模板。 如果你有统一的标记客户端,我们建议你使用基于标签的 cmdlet,而不是直接修改保护模板。

有关详细信息,请参阅 Microsoft 365 文档中 的“创建和发布敏感度标签 ”。

示例

示例 1:获取模板的说明和使用权限

PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions

此命令获取为指定保护模板配置的所有用户或组的说明和使用权限。

示例 2:对于所有模板,获取名称、使用权限、默认模板以及已发布还是存档

PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}

第一个命令获取所有模板 ID 并将其存储在变量中。 然后,第二个命令使用此变量获取模板名称、使用权限、默认模板的只读 (True 、自定义模板) False 以及每个模板 (已发布存档) 的状态。

参数

-ContentExpirationDate

列出使用模板保护的内容过期的日期。

仅当 ContentExpirationOption 设置为 OnDate 时,才使用此参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContentExpirationOption

获取受模板保护的内容的内容过期配置设置。

将返回下列值之一:

  • Never。 指示内容永久可用。

  • OnDate。 指示内容将在特定的固定日期到期。

  • AfterDays. 指示内容在受保护后的指定天数内可用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContentValidityDuration

列出保护之日起的天数,之后受模板保护的内容过期。

仅当 ContentExpirationOption 设置为 AfterDays 时,才使用此参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Descriptions

列出所有区域设置中模板的说明。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableInLegacyApps

指示不支持部门模板的应用程序中部门模板的行为, (看到 ScopedIdentities 参数) 。

如果设置为 True 并且模板是部门模板,则所有尝试保护不支持部门模板的应用程序的内容都将看到该模板,因此,无论用户是否是模板的目标范围的成员,都可以选择它。

如果设置为 False,则不会看到任何用户,因此无法在不支持部门模板的应用程序中选择模板,即使用户是模板的目标范围的成员也是如此。

对于非部门模板,此设置不起作用;对于原本就支持部门模板的应用程序,此设置也不起作用。

在 Azure 经典门户中配置 APPLICATION COMPATIBILITY 时,当应用程序不支持用户标识复选框时,此参数的功能等效于显示此模板, (现在已停用) 。 Azure 门户中没有等效的设置。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LicenseValidityDuration

列出获取许可证后可脱机访问内容的天数。

-1 表示无限制的访问。

0 表示必须为每个用途获取许可证,并且内容仅联机可用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Names

列出所有区域设置中模板的名称。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReadOnly

指示模板是默认模板 (True) ,因此无法编辑或删除,或者自定义模板 (False) ,因此可由管理员编辑或删除。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RightsDefinitions

列出为受模板保护的内容授予用户或组的权限。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ScopedIdentities

按电子邮件地址(帐户或组)列出用户,这些用户可以查看并因而可以从应用程序选择部门模板。

对于指定的用户要查看模板,应用程序必须支持部门模板,或者 EnableInLegacyApps 参数必须设置为 True

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Status

模板的状态:

- 存档 模板可用于使用以前受保护的内容,但不会向用户显示。

- 已发布 的模板可供用户保护内容。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TemplateId

指定保护模板的 GUID。

可以使用 Get-AipServiceTemplate cmdlet 获取所有模板的模板 ID。

类型:Guid
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False