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 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.

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

mgc device-management virtual-endpoint cloud-pcs rename post --cloud-pcid {cloudPC-id} --body '{\
  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