cloudPC: umbenennen

Namespace: microsoft.graph

Benennen Sie ein bestimmtes cloudPC-Objekt um. Verwenden Sie diese API, um den displayName einer Cloud-PC-Entität zu aktualisieren.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

Um den angegebenen cloudPC im organization umzubenennen, verwenden Sie entweder die delegierte Berechtigung (der angemeldete Benutzer sollte der Administrator sein) oder die Anwendungsberechtigung:

POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename

Anforderungsheader

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

Die folgende Tabelle zeigt den Parameter, den Sie mit dieser Aktion verwenden können.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Umbenennen eines Cloud-PCs für den Administrator.

POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/c2bbb5dd-2574-451b-a508-bbaa6ac48ace/rename
Content-Type: application/json

{
  displayName: "Cloud PC-HR"
}

const options = {
	authProvider,
};

const client = Client.init(options);

const rename = {
  displayName: 'Cloud PC-HR'
};

await client.api('/deviceManagement/virtualEndpoint/cloudPCs/c2bbb5dd-2574-451b-a508-bbaa6ac48ace/rename')
	.post(rename);

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content