New-PlaceholderSetting

Creates new placeholder setting definition that can later be added to an item.

Syntax

New-PlaceholderSetting [-Item] <Item> [-Key <string>] [-Language <string[]>]

New-PlaceholderSetting [-Path] <string> [-Key <string>] [-Language <string[]>]

New-PlaceholderSetting -Id <string> [-Key <string>] [-Language <string[]>] [-Database <string>]

Detailed Description

Creates new placeholder setting definition that can later be added to an item. Most parameters can later be overriden when calling Add-PlaceholderSetting.

© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions

Parameters

-Database <string>

Database containing the item to be processed - can work with Language parameter to narrow the publication scope.

Aliases	None
Required?	false
Position?	Named
Default Value
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Id <string>

Id of the item to be processed - can work with Language parameter to narrow the publication scope.

Aliases	None
Required?	true
Position?	Named
Default Value
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Item <Item>

The item to be processed.

Aliases	None
Required?	true
Position?	0
Default Value
Accept Pipeline Input?	true (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-Key <string>

The key for this placeholder setting.

Aliases	None
Required?	false
Position?	Named
Default Value
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Language <string[]>

Language that will be used as source language. If not specified the current user language will be used. Globbing/wildcard supported.

Aliases	Languages
Required?	false
Position?	Named
Default Value
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Path <string>

Path to the item to be processed - can work with Language parameter to narrow the publication scope.

Aliases	FullName, FileName
Required?	true
Position?	0
Default Value
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

• Sitecore.Data.Items.Item

Outputs

The output type is the type of the objects that the cmdlet emits.

• Sitecore.Layouts.PlaceholderDefinition

Examples

EXAMPLE 1

Create item defining placeholder setting

$placeholderSetting = gi "master:\layout\Placeholder Settings\content" | New-PlaceholderSetting -Key "content"

Related Topics

• https://github.com/SitecorePowerShell/Console/

• Add-PlaceholderSetting

• Get-PlaceholderSetting

• Remove-PlaceholderSetting