Skip to main content

spo eventreceiver get

Retrieves specific event receiver for the specified web, site or list by event receiver name or id.

Usage​

m365 spo eventreceiver get [options]

Options​

-u, --webUrl <webUrl>

The URL of the web for which to retrieve the event receivers.

--listTitle [listTitle]

The title of the list for which to retrieve the event receivers, if the event receivers should be retrieved from a list. Specify either listTitle, listId or listUrl.

--listId [listId]

The id of the list for which to retrieve the event receivers, if the event receivers should be retrieved from a list. Specify either listTitle, listId or listUrl.

--listUrl [listUrl]

The url of the list for which to retrieve the event receivers, if the event receivers should be retrieved from a list. Specify either listTitle, listId or listUrl.

-n, --name [name]

The name of the event receiver to retrieve. Specify either name or id but not both.

-i, --id [id]

The id of the event receiver to retrieve. Specify either name or id but not both.

-s, --scope [scope]

The scope of which to retrieve the event receivers. Can be either site or web. Defaults to web. Only applicable when not specifying any of the list properties.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Examples​

Retrieve event receivers in web https://contoso.sharepoint.com/sites/contoso-sales with name PnP Test Receiver.

m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'PnP Test Receiver'

Retrieve event receivers in site https://contoso.sharepoint.com/sites/contoso-sales with id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec.

m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec

Retrieve event receivers for list with title Events in web https://contoso.sharepoint.com/sites/contoso-sales with name PnP Test Receiver.

m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --name 'PnP Test Receiver'

Retrieve event receivers for list with ID 202b8199-b9de-43fd-9737-7f213f51c991 in web https://contoso.sharepoint.com/sites/contoso-sales with id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec.

m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991' --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec

Retrieve event receivers for list with url /sites/contoso-sales/lists/Events in web https://contoso.sharepoint.com/sites/contoso-sales with name PnP Test Receiver.

m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events' --name 'PnP Test Receiver'

Response​

{
  "ReceiverAssembly": "Microsoft.Office.Server.UserProfiles, Version=16.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c",
  "ReceiverClass": "Microsoft.Office.Server.UserProfiles.ContentFollowingWebEventReceiver",
  "ReceiverId": "c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec",
  "ReceiverName": "PnP Test Receiver",
  "SequenceNumber": 10000,
  "Synchronization": 2,
  "EventType": 10204,
  "ReceiverUrl": "https://northeurope1-0.pushnp.svc.ms/notifications?token=b4c0def2-a5ea-490a-bb85-c2e423b1384b"
}