calendarserver_manage_principals
- Darwin Calendar Server principal management utility
SYNOPSIS
[--config file
]
[--read-property property
]
[--list-read-proxies
]
[--list-write-proxies
]
[--list-proxies
]
[--add-read-proxy principal
]
[--add-write-proxy principal
]
[--remove-proxy principal
]
[--set-auto-schedule true|false
]
[--get-auto-schedule
]
principal
[principal ...]
DESCRIPTION
is a tool for accessing and manipulating information regarding
principals on a Darwin Calendar Server. Principals represent any form
of actor that can access the server, such as users, groups, locations
and resources.
should be run as a user with the same priviledges as the Calendar
Server itself, as it needs to read and write data that belongs to the
server.
takes a list of principals as arguments and then performs the
requested actions on each of the given principals.
A principal may be specified as the principal's GUID. Alternatively,
it may be specified in the form
recordType:shortName
where
recordType
is a
directory record type (eg.
usersgroupslocationsresources
and
shortName
is the principal's short name.
Actions to perform are specified via the options below. Multiple
actions may be given, and will be performed in the order given on
each principal specified.
OPTIONS
-h, -help
Displays usage information
-f, -config FILE
Use the Calendar Server configuration specified in the given file. Defaults to /etc/caldavd/caldavd.plist.
ACTIONS
--read-property property
Read the given WebDAV property on the principal resource.
property
must be a fully qualified XML element name in the form
{namespace}name
for example:
{DAV:}displayname
--list-read-proxies
List the read proxies.
--list-write-proxies
List the write proxies.
--list-proxies
List all proxies.
--add-read-proxy principal
Add the given
principal
as a read proxy.
--add-write-proxy principal
Add the given
principal
as a write proxy.
--remove-proxy principal
Remove the given
principal
as a proxy.
--set-auto-schedule true|false
Enable or disable automatic scheduling.
--get-auto-schedule
Get the automatic scheduling state.
EXAMPLES
Add Alice and Bob as read proxies for Joe and display the list of Joe's proxies: