Skip to content

Latest commit

 

History

History
135 lines (108 loc) · 3.17 KB

Add-PnPViewsFromXML.md

File metadata and controls

135 lines (108 loc) · 3.17 KB
Module Name schema applicable online version external help file title
PnP.PowerShell
2.0.0
SharePoint Online
PnP.PowerShell.dll-Help.xml
Add-PnPViewsFromXML

Add-PnPViewsFromXML

SYNOPSIS

Adds one or more views to a list from an XML string.

SYNTAX

Add-PnPViewsFromXML [-List] <ListPipeBind> [-ViewsXML <String>] 
 [-Connection <PnPConnection>]

DESCRIPTION

This cmdlet allows the creation of one or more views on a SharePoint Online list based on passing in an XML definition with the view details.

EXAMPLES

EXAMPLE 1

$viewsXML = @"
<ListViews>
   <List Type='GenericList'>
     <View Name='Demo View' ViewTypeKind='Html' OrderedView='TRUE' ViewFields='Author,Created,Editor,Modified' RowLimit='30' DefaultView='TRUE'>
       <ViewQuery>
         <OrderBy>
           <FieldRef Name='ID' Ascending='FALSE'/>
         </OrderBy>
       </ViewQuery>
     </View>
    </List>
</ListViews>
"@

Add-PnPViewsFromXML -List "Demo List" -ViewsXML $viewsXML

Adds one view named "Demo view" to the "Demo List" list from the XML string.

EXAMPLE 2

$viewsXML = @"
<ListViews>
   <List Type='GenericList'>
     <View Name='Demo View' ViewTypeKind='Html' OrderedView='TRUE' ViewFields='Author,Created,Editor,Modified' RowLimit='30' DefaultView='TRUE'>
       <ViewQuery>
         <OrderBy>
           <FieldRef Name='ID'  Ascending='FALSE'/>
         </OrderBy>
       </ViewQuery>
     </View>
    </List>
    <List Type='GenericList'>
     <View Name='Created By Me' ViewTypeKind='Html' OrderedView='TRUE' ViewFields='Author,Created,Editor,Modified' RowLimit='30' DefaultView='FALSE'>
       <ViewQuery>
         <Where>
           <Eq>
             <FieldRef Name='Author' />
             <Value Type='Integer'>
               <UserID Type='Integer' />
             </Value>
           </Eq>
         </Where>
         <OrderBy>
           <FieldRef Name='Created' Ascending='FALSE'/>
         </OrderBy>
       </ViewQuery>
     </View>
    </List>
</ListViews>
"@

Add-PnPViewsFromXML -List "Demo List" -ViewsXML $viewsXML

Adds two views named "Demo view" and "Created By Me" to the "Demo List" list from the XML string.

PARAMETERS

-Connection

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

Type: PnPConnection
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-List

The ID or Url of the list to add the view to.

Type: ListPipeBind
Parameter Sets: (All)

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ViewsXML

The XML string of the view(s) that you want to add to the list.

Type: string
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

RELATED LINKS

Microsoft 365 Patterns and Practices