„printerShare“ erstellen
Namespace: microsoft.graph
Erstellen Sie eine neue printerShare-Datei für den angegebenen Drucker.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | PrinterShare.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
POST /print/shares
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des printerShare-Objekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von printerShare bereitgestellt werden können.
Eigenschaft | Typ | Beschreibung | Pflichtfeld? |
---|---|---|---|
Drucker | microsoft.graph.printer | Der Drucker, mit dem dieser Druckerfreigabe verknüpft ist. Verwenden Sie die printer@odata.bind Syntax, wie im folgenden Beispiel gezeigt. |
Ja |
displayName | String | Der Name der Druckerfreigabe, die von Druckclients angezeigt werden soll. Die maximal zulässige Länge beträgt 50 Zeichen. | Ja |
allowAllUsers | Boolesch | Gibt true an, dass allen Benutzern und Gruppen Zugriff auf diese Druckerfreigabe gewährt wird. Dadurch werden die durch die Navigationseigenschaften allowedUsers und allowedGroups definierten Zulassungslisten ersetzt. |
Nein |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und ein printerShare-Objekt im Antworttext zurückgegeben.
Beispiele
Anforderung
POST https://graph.microsoft.com/v1.0/print/shares
Content-Type: application/json
{
"displayName": "ShareName",
"allowAllUsers": false,
"printer@odata.bind": "https://graph.microsoft.com/v1.0/print/printers/{printerId}"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
"id": "d837c17b-3296-4384-a053-828d56e10f50",
"displayName": "ShareName",
"createdDateTime": "2020-02-04T00:00:00.0000000Z",
"isAcceptingJobs": true,
"allowAllUsers": false,
"status": {
"state": "ready",
"details": [],
"description": ""
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für