<!--
{
  "availability" : [
    "macOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/ScreenSharingConnection",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rmdm-declarations:ScreenSharingConnection"
  },
  "title" : "ScreenSharingConnection"
}
-->

# ScreenSharingConnection

The declaration to configure a connection to a screen-sharing host.

```
object ScreenSharingConnection
```

## Discussion

Specify `com.apple.configuration.screensharing.connection` as the declaration type.

### Configuration availability

|||
|--------------------------------|----------------------------------------------|
|Allowed in supervised enrollment|macOS                                         |
|Allowed in device enrollment    |N/A                                           |
|Allowed in user enrollment      |macOS                                         |
|Allowed in local enrollment     |macOS                                         |
|Allowed in system scope         |macOS                                         |
|Allowed in user scope           |macOS                                         |
|Apply                           |Multiple configurations are applied separately|

### Configuration example

This configuration sets up a screen-sharing connection to a remote Mac.

```json
{
    "Type": "com.apple.configuration.screensharing.connection",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "ConnectionUUID": "FA80E209-B31B-4862-B880-399F79E8FC35",
        "HostName": "example.com",
        "DisplayName": "Host1",
        "DisplayConfiguration": {
            "DisplayType": "Virtual1"
        }
    }
}
```

## Topics

### Objects

[`ScreenSharingConnectionDisplayConfigurationObject`](/documentation/DeviceManagement/ScreenSharingConnectionDisplayConfigurationObject)

The display configuration for this connection.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)