Get-AipServiceTemplateProperty
取得 Azure 資訊保護的保護範本屬性。
Syntax
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>] Description
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}第一個命令會取得所有範本識別碼，並將其儲存在變數中。 第二個命令接著會使用此變數來取得範本名稱、許可權、如果是預設範本的唯讀 (True 、自訂範本) 則為 False ，以及每個範本的 [已發佈 ] 或 [ 封存 ] 狀態 () 。
參數
-ContentExpirationDate
列出受範本保護內容的到期日期。
只有當 ContentExpirationOption 設定為 OnDate時，才使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentExpirationOption
取得受範本保護之內容的內容到期組態設定。
傳回值會是下列其中之一：
Never。 指出內容可無限期使用。
OnDate。 指出內容會在某個固定日期到期。
AfterDays。 指出內容在受到保護後的指定天數內可供使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentValidityDuration
列出保護日期之後，受範本保護的內容到期的天數。
只有在 ContentExpirationOption 設定為 AfterDays 時，才使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Descriptions
列出所有地區設定中範本的描述。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableInLegacyApps
指出不支援部門範本之應用程式中部門範本的行為， (請參閱 ScopedIdentities 參數) 。
如果設定為 True，而且範本是部門範本，所有嘗試保護不支援部門範本之應用程式的內容都會看到範本，因此無論使用者是否為範本目標範圍的成員，都能加以選取。
如果設定為 False，則使用者看不到，因此無法在不支援部門範本的應用程式中選取範本，即使使用者是範本目標範圍的成員也一樣。
此設定不會對部門範本以外的範本產生影響，而且也不會對原生支援部門範本的應用程式產生影響。
當您在 Azure 傳統入口網站中設定應用程式相容性時，此參數的功能相當於 [在 Azure 傳統入口網站中設定應用程式相容性時，對所有使用者顯示此範本給所有使用者] 核取方塊， (現在已淘汰) 。 Azure 入口網站中沒有對等的設定。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseValidityDuration
列出取得授權之後，內容可離線存取的天數。
-1 表示無限制存取。
0 表示必須針對每個用途取得授權，且該內容只能在線上使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Names
列出所有地區設定中範本的名稱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadOnly
指出範本是預設範本 (True) ，因此無法編輯或刪除，或是自訂範本 (False) ，因此可由系統管理員編輯或刪除。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RightsDefinitions
針對使用範本保護的內容，列出授與使用者或群組的許可權。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScopedIdentities
列出可從應用程式看到並選取部門範本之使用者的電子郵件地址 (帳戶或群組)。
若要讓指定的使用者看到範本，應用程式必須支援部門範本，或 EnableInLegacyApps 參數必須設定為 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Status
範本的狀態：
-封存 的範本可用來取用先前受保護的內容，但不會向使用者顯示。
-已發佈 的範本可供使用者保護內容。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateId
指定保護範本的 GUID。
您可以使用 Get-AipServiceTemplate Cmdlet 來取得所有範本的範本識別碼。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |