Abrufen von Profilvorlagen

Artikel
03/22/2025

Ruft eine Liste der Profilvorlagen ab, für die der angegebene Benutzer sich registrieren kann. Diese Methode gibt eine eingeschränkte Ansicht der Profilvorlage zurück. Die zurückgegebenen Profilvorlagendaten sollten ausreichen, damit der anfordernde Benutzer entscheiden kann, für welche Profilvorlage er sich ggf. registrieren muss. Wenn kein Workflow und keine Berechtigung angegeben sind, werden alle Profilvorlagen zurückgegeben, die für den Benutzer sichtbar sind.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode	Anforderungs-URL
ERHALTEN/Bekommen	/CertificateManagement/api/v1.0/profiletemplates? [targetuser]

URL-Parameter

Parameter	BESCHREIBUNG
targetuser	Wahlfrei. Gibt den Zielbenutzer an, für den Profilvorlagen zurückgegeben werden sollen. Wenn nicht angegeben, wird die Identität des aktuellen Benutzers verwendet. Hinweis: Derzeit wird nur der aktuelle Benutzer unterstützt.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code	BESCHREIBUNG
200	OKAY
204	Kein Inhalt
500	Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg eine Liste von ProfileTemplateLimitedView-Objekten mit den folgenden Eigenschaften zurück:

Eigentum	Typ	BESCHREIBUNG
Name	Schnur	Der Anzeigename der Profilvorlage.
BESCHREIBUNG	Schnur	Die Beschreibung für die Profilvorlage.
Uuid	Guid	Der Bezeichner für die Profilvorlage.
IsSmartcardProfileTemplate	Boolesch	Gibt an, ob es sich bei der Vorlage um eine Smartcardprofilvorlage handelt.
IsVirtualSmartcardProfileTemplate	Boolesch	Gibt an, ob für die Profilvorlage eine virtuelle Smartcard erforderlich ist.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen der Liste der Profilvorlagen für den angegebenen Benutzer.

Beispiel: Anforderung

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

Beispiel: Antwort

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
    }
]

Freigeben über