Skip to content

Latest commit

 

History

History
129 lines (95 loc) · 2.78 KB

Get-PnPCustomAction.md

File metadata and controls

129 lines (95 loc) · 2.78 KB
external help file applicable schema
SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
2.0.0

Get-PnPCustomAction

SYNOPSIS

Return user custom actions

SYNTAX

Get-PnPCustomAction [-Identity <GuidPipeBind>]
                    [-Scope <CustomActionScope>]
                    [-ThrowExceptionIfCustomActionNotFound [<SwitchParameter>]]
                    [-Web <WebPipeBind>]
                    [-Includes <String[]>]
                    [-Connection <SPOnlineConnection>]

DESCRIPTION

Returns all or a specific user custom action

EXAMPLES

------------------EXAMPLE 1------------------

PS:> Get-PnPCustomAction

Returns all custom actions of the current site.

------------------EXAMPLE 2------------------

PS:> Get-PnPCustomAction -Identity aa66f67e-46c0-4474-8a82-42bf467d07f2

Returns the custom action with the id 'aa66f67e-46c0-4474-8a82-42bf467d07f2'.

------------------EXAMPLE 3------------------

PS:> Get-PnPCustomAction -Scope web

Returns all custom actions for the current web object.

PARAMETERS

-Identity

Identity of the CustomAction to return. Omit to return all CustomActions.

Type: GuidPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Includes

Specify properties to include when retrieving objects from the server.

Type: String[]
Parameter Sets: 

Required: False
Position: 0
Accept pipeline input: False

-Scope

Scope of the CustomAction, either Web, Site or All to return both

Type: CustomActionScope
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-ThrowExceptionIfCustomActionNotFound

Switch parameter if an exception should be thrown if the requested CustomAction does not exist (true) or if omitted, nothing will be returned in case the CustomAction does not exist

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Web

The web to apply the command to. Omit this parameter to use the current web.

Type: WebPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Connection

Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: SPOnlineConnection
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

OUTPUTS

RELATED LINKS

SharePoint Developer Patterns and Practices