Get-AipServiceTemplateProperty
取得 Azure 資訊保護的保護範本屬性。
語法
Default (預設值)
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,而不是直接修改您的保護範本。
範例
範例 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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentExpirationOption
取得使用範本保護之內容的內容到期組態設定。
傳回下列其中一個值:
永不。 表示內容無限期可用。
OnDate。 指出內容在特定固定日期到期。
AfterDays。 表示內容在受保護后的指定天數內可供使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentValidityDuration
列出保護日後的天數,之後會使用範本保護的內容到期。
只有當 contentExpirationOption 設定為
參數屬性
| 類型: | 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 傳統入口網站中設定
參數屬性
| 類型: | 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 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 來取得所有範本的範本識別碼。
參數屬性
| 類型: | 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。