Set-SPOList

Configures the specified list.

Set-SPOList [-ContentTypesEnabled [<Boolean>]] [-DefaultContentApprovalWorkflowId [<Guid>]] [-DefaultDisplayFormUrl [<String>]] [-DefaultEditFormUrl [<String>]] [-DefaultNewFormUrl [<String>]] [-Description [<String>]] [-Direction [<String>]] [-DocumentTemplateUrl [<String>]] [-DraftVersionVisibility [<DraftVisibilityType>]] [-EnableAttachments [<Boolean>]] [-EnableFolderCreation [<Boolean>]] [-EnableMinorVersions [<Boolean>]] [-EnableModeration [<Boolean>]] [-EnableVersioning [<Boolean>]] [-ForceCheckout [<Boolean>]] [-Hidden [<Boolean>]] [-ImageUrl [<String>]] [-IrmEnabled [<Boolean>]] [-IrmExpire [<Boolean>]] [-IrmReject [<Boolean>]] [-IsApplicationList [<Boolean>]] [-LastItemModifiedDate [<DateTime>]] [-MultipleDataList [<Boolean>]] [-NoCrawl [<Boolean>]] [-OnQuickLaunch [<Boolean>]] [-Title [<String>]] [-ValidationFormula [<String>]] [-ValidationMessage [<String>]] -Web <SPOWebPipeBind> [-Identity [<SPOListPipeBind>]]

Set-SPOList -BreakRoleInheritance <SwitchParameter> [-CopyRoleAssignments [<SwitchParameter>]] [-ClearScopes [<SwitchParameter>]] -Web <SPOWebPipeBind> [-Identity [<SPOListPipeBind>]]

Set-SPOList -ResetRoleInheritance <SwitchParameter> -Web <SPOWebPipeBind> [-Identity [<SPOListPipeBind>]]

Parameters

1

ParameterRequiredTypeDescription
ContentTypesEnabledFalseBoolean

Sets a value that specifies whether Content Types are enabled for the List.

DefaultContentApprovalWorkflowIdFalseGuid

Sets a value that specifies the default workflow identifier for content approval on the List.

DefaultDisplayFormUrlFalseString

Sets a value that specifies the location of the default display form for the List.

DefaultEditFormUrlFalseString

Sets a value that specifies the URL of the edit form to use for List items in the List.

DefaultNewFormUrlFalseString

Sets a value that specifies the location of the default new form for the List.

DescriptionFalseString

Sets a value that specifies the description of the List.

DirectionFalseString

Sets a value that specifies the reading order of the List. Valid values are NONE, LTR, or RTL.

DocumentTemplateUrlFalseString

Sets a value that specifies the server-relative URL of the document template for the List.

DraftVersionVisibilityFalseDraftVisibilityType

Sets a value that specifies the minimum permission required to view minor versions and drafts within the List.

EnableAttachmentsFalseBoolean

Sets a value that specifies whether List item attachments are enabled for the List.

EnableFolderCreationFalseBoolean

Sets a value that specifies whether new List folders can be added to the List.

EnableMinorVersionsFalseBoolean

Sets a value that specifies whether minor versions are enabled for the List.

EnableModerationFalseBoolean

Sets a value that specifies whether content approval is enabled for the List.

EnableVersioningFalseBoolean

Sets a value that specifies whether historical versions of List items and documents can be created in the List.

ForceCheckoutFalseBoolean

Sets a value that specifies whether List items must be checked out before they can be edited.

HiddenFalseBoolean

Sets a Boolean value that specifies whether the List is hidden.

ImageUrlFalseString

Sets a value that specifies the URI for the icon of the List.

IrmEnabledFalseBoolean

Sets a value that specifies whether information rights management is enabled for the List.

IrmExpireFalseBoolean

IrmRejectFalseBoolean

IsApplicationListFalseBoolean

Sets a value that specifies a flag that a client application can use to determine whether to display the List.

LastItemModifiedDateFalseDateTime

Sets a value that specifies the last time a List item, field, or property of the List was modified.

MultipleDataListFalseBoolean

NoCrawlFalseBoolean

Sets a value that specifies that the crawler must not crawl the List.

OnQuickLaunchFalseBoolean

Sets a value that specifies whether the List appears on the Quick Launch of the Site.

TitleFalseString

Sets the displayed title for the List.

ValidationFormulaFalseString

Sets a value that specifies the data validation criteria for a List item.

ValidationMessageFalseString

Sets a value that specifies the error message returned when data validation fails for a List item.

WebTrueSPOWebPipeBind

Specifies the identity of the Site containing the List to update.

The type must be a valid server relative URL, in the form /site_name, or an SPOWeb object, Microsoft.SharePoint.Client.Web object, or GUID representing the Site ID.

IdentityFalseSPOListPipeBind

Specifies the identity of the List to update.

The type must be a valid absolute URL, in the form http://contoso.sharepoint.com/site_name/lists/list_name, or an SPOList object, Microsoft.SharePoint.Client.List object, List title, or GUID representing the List ID.

2

ParameterRequiredTypeDescription
BreakRoleInheritanceTrueSwitchParameter

Creates unique role assignments for the Site.

CopyRoleAssignmentsFalseSwitchParameter

Specifies whether to copy the role assignments from the parent Site.

ClearScopesFalseSwitchParameter

The role assignments for all child Sites in the current Site and in the Sites which inherit role assignments from the current Site must be cleared and those Sites will inherit role assignments from the current Site after this call.

WebTrueSPOWebPipeBind

Specifies the identity of the Site containing the List to update.

The type must be a valid server relative URL, in the form /site_name, or an SPOWeb object, Microsoft.SharePoint.Client.Web object, or GUID representing the Site ID.

IdentityFalseSPOListPipeBind

Specifies the identity of the List to update.

The type must be a valid absolute URL, in the form http://contoso.sharepoint.com/site_name/lists/list_name, or an SPOList object, Microsoft.SharePoint.Client.List object, List title, or GUID representing the List ID.

3

ParameterRequiredTypeDescription
ResetRoleInheritanceTrueSwitchParameter

Resets the role inheritance for the Site and inherits role assignments from the parent Site.

WebTrueSPOWebPipeBind

Specifies the identity of the Site containing the List to update.

The type must be a valid server relative URL, in the form /site_name, or an SPOWeb object, Microsoft.SharePoint.Client.Web object, or GUID representing the Site ID.

IdentityFalseSPOListPipeBind

Specifies the identity of the List to update.

The type must be a valid absolute URL, in the form http://contoso.sharepoint.com/site_name/lists/list_name, or an SPOList object, Microsoft.SharePoint.Client.List object, List title, or GUID representing the List ID.

Detailed Description

The Set-SPOList cmdlet configures the list specified by the Identity parameter. Settings for any parameters that are not provided are not changed.

Copyright 2016 Falchion Consulting, LLC

> For more information on this cmdlet and others:

> http://blog.falchionconsulting.com/

> Use of this cmdlet is at your own risk.

> Gary Lapointe assumes no liability.

Examples

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

PS C:\> Set-SPOWeb -Identity "/childsite" -BreakRoleInheritance -CopyRoleAssignments

This example breaks permissions inheritance for /childsite and copies the parents permissions to the Site.

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

PS C:\> Set-SPOWeb -Identity "/" -CustomMasterUrl "/_catalogs/masterpage/seattle.master"

This example sets the master page of the root Site of a Site Collection to seattle.master.