Table of Contents

Set-PnPPropertyBagValue

SYNOPSIS

Adds a new or updates an existing property bag value.

SYNTAX

Web

Set-PnPPropertyBagValue -Key <String> -Value <String> [-Indexed] [-Force] 
 [-Connection <PnPConnection>] 

Folder

Set-PnPPropertyBagValue -Key <String> -Value <String> [-Folder <String>] [-Force] 
 [-Connection <PnPConnection>] 

DESCRIPTION

Updates an existing property bag value or adds it as a new key\value pair if it doesn't exist yet. If working with a modern SharePoint Online site or having noscript enabled, you will have to disable this yourself temporarily using Set-PnPTenantSite -Url <url> -NoScriptSite:$false to be able to make the change.

EXAMPLES

EXAMPLE 1

Set-PnPPropertyBagValue -Key MyKey -Value MyValue

This sets or adds a value to the current web property bag.

EXAMPLE 2

Set-PnPPropertyBagValue -Key MyKey -Value MyValue -Folder /

This sets or adds a value to the root folder of the current web.

EXAMPLE 3

Set-PnPPropertyBagValue -Key MyKey -Value MyValue -Folder /MyFolder

This sets or adds a value to the folder MyFolder which is located in the root folder of the current web.

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

-Folder

Site relative url of the folder. See examples for use.

Type: String
Parameter Sets: Folder

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

-Indexed

Sets the key to be indexed, which makes the property bag value searchable.

Type: SwitchParameter
Parameter Sets: Web

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

-Key

Key of the property to set.

Type: String
Parameter Sets: (All)

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

-Value

Value to set.

Type: String
Parameter Sets: (All)

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

-Force

If provided, no confirmation will be asked to remove the value from the property bag. It will also temporarily enable scripts on the site and then disable it after setting property bag value.

Type: SwitchParameter
Parameter Sets: (All)

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

Microsoft 365 Patterns and Practices