共用方式為


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 設為 OnDate時,才使用此參數。

參數屬性

類型: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 設定為 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 傳統入口網站中設定 APPLICATION COMPATIBILITY 時,此參數的功能相當於在 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 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