取得設定檔範本

發行項
09/14/2023

取得指定使用者可以註冊的設定檔範本清單。此方法會傳回設定檔範本的有限檢視。傳回的設定檔範本資料應該足以讓要求使用者決定需要註冊哪一個設定檔範本 (如果有的話)。如果未指定任何工作流程和許可權，則會傳回使用者可以看到的所有設定檔範本。

注意

本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。

要求

方法	要求 URL
GET	/CertificateManagement/api/v1.0/profiletemplates？[targetuser]

URL 參數

參數	描述
targetuser	選擇性。指定要傳回設定檔範本的目標使用者。如果未指定，則會使用目前使用者的身分識別。注意：目前僅支援現行使用者。

要求標頭

如需常見的要求標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。

要求本文

無。

回應

本節說明回應。

回應碼

程式碼	描述
200	[確定]
204	沒有內容
500	內部錯誤

回應標頭

如需常見的回應標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。

回應本文

成功時，會傳回具有下列屬性的 ProfileTemplateLimitedView 物件清單：

屬性	類型	描述
名稱	字串	設定檔範本的顯示名稱。
描述	字串	設定檔範本的描述。
Uuid	Guid	設定檔範本的識別碼。
IsSmartcardProfileTemplate	bool	指出範本是否為智慧卡設定檔範本。
IsVirtualSmartcardProfileTemplate	bool	指出設定檔範本是否需要虛擬智慧卡。

範例

本節提供一個範例，以取得指定使用者的設定檔範本清單。

範例：要求

GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1

範例：回應

HTTP/1.1 200 OK

[
    {
        "Name":"FIM CM Sample Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
        "IsSmartcardProfileTemplate":false,
        "IsVirtualSmartcardProfileTemplate":false
    },
    {
        "Name":"FIM CM Sample Smart Card Logon Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
        "IsSmartcardProfileTemplate":true,
        "IsVirtualSmartcardProfileTemplate":false
    }
]

共用方式為