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。