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

Get-AipServiceTemplateProperty

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

语法

Default (默认值)

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,而不是直接修改保护模板。

示例

示例 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
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContentExpirationOption

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

返回以下值之一:

  • 从不。 指示内容无限期可用。

  • onDate。 指示内容在特定固定日期过期。

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContentValidityDuration

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Descriptions

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EnableInLegacyApps

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

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

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

此设置对不是部门模板的模板没有影响,也不会影响本机支持部门模板的应用程序。

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LicenseValidityDuration

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

-1 表示无限制的访问。

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Names

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReadOnly

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RightsDefinitions

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ScopedIdentities

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Status

模板的状态:

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TemplateId

指定保护模板的 GUID。

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

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters