Get-AipServiceTemplateProperty
取得 Azure 資訊保護的保護範本屬性。
語法
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
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContentExpirationOption
取得使用範本保護之內容的內容到期組態設定。
傳回下列其中一個值:
永不。 表示內容無限期可用。
OnDate。 指出內容在特定固定日期到期。
AfterDays。 表示內容在受保護后的指定天數內可供使用。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContentValidityDuration
列出保護日後的天數,之後會使用範本保護的內容到期。
只有當 contentExpirationOption 設定為
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Descriptions
列出所有地區設定中範本的描述。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-EnableInLegacyApps
指出不支援部門範本之應用程式中部門範本的行為(請參閱 ScopedIdentities 參數)。
如果設定為 True 且範本是部門範本,則嘗試保護內容不受不支援部門範本之應用程式的所有用戶都會看到範本,因此無論使用者是否為範本目標範圍的成員,都能加以選取。
如果設定為 False,則不會看到任何使用者,因此無法在不支援部門範本的應用程式中選取範本,即使使用者是範本目標範圍的成員也一樣。
此設定不會影響不是部門範本的範本,也不會影響原生支援部門範本的應用程式。
當您在 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 true。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Status
樣本的狀態:
- 封存 範本可用來取用先前受保護的內容,但不會向用戶顯示。
- 已發佈 範本可供使用者保護內容。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-TemplateId
指定保護範本的 GUID。
您可以使用 Get-AipServiceTemplate Cmdlet 來取得所有範本的範本識別碼。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |