Remove-PlaceholderSetting
Removes placeholder setting(s) from an item using the filtering parameters.

Syntax

1
Remove-PlaceholderSetting -Item <Item> [-Key <string>] [-PlaceholderSetting <Item>] [-Index <int>] [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
2
​
3
Remove-PlaceholderSetting -Item <Item> -Instance <PlaceholderDefinition> [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
4
​
5
Remove-PlaceholderSetting -Item <Item> -UniqueId <string> [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
6
​
7
Remove-PlaceholderSetting -Path <string> [-Key <string>] [-PlaceholderSetting <Item>] [-Index <int>] [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
8
​
9
Remove-PlaceholderSetting -Path <string> -Instance <PlaceholderDefinition> [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
10
​
11
Remove-PlaceholderSetting -Path <string> -UniqueId <string> [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
12
​
13
Remove-PlaceholderSetting [-Id <string>] [-Database <string>] [-Key <string>] [-PlaceholderSetting <Item>] [-Index <int>] [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
14
​
15
Remove-PlaceholderSetting -Instance <PlaceholderDefinition> [-Id <string>] [-Database <string>] [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
16
​
17
Remove-PlaceholderSetting -UniqueId <string> [-Id <string>] [-Database <string>] [-Device <DeviceItem>] [-FinalLayout] [-Language <string[]>]
Copied!

Detailed Description

Removes placeholder setting(s) from an item using the filtering parameters.
© 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

-Device <DeviceItem>

Device for which the placeholder settings will be removed.
Aliases
None
Required?
false
Position?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false

-FinalLayout <switch>

Targets the Final Layout. If not provided, the Shared Layout will be targeted. Applies to Sitecore 8.0 and higher only.
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?
false
Position?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false

-Index <int>

Index at which the placeholder setting exists in the layout. The placeholder setting at that index will be removed.
Aliases
None
Required?
false
Position?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false

-Instance <PlaceholderDefinition>

Specific instance of placeholder setting that should be removed. The instance could earlier be obtained through e.g. use of Get-PlaceholderSetting.
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?
Named
Default Value
​
Accept Pipeline Input?
true (ByValue, ByPropertyName)
Accept Wildcard Characters?
false

-Key <string>

Placeholder key filter - supports wildcards.
Aliases
None
Required?
false
Position?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
true

-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?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false

-PlaceholderSetting <Item>

Item representing the placeholder setting. If matching, the placeholder setting will be removed.
Aliases
None
Required?
false
Position?
Named
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false

-UniqueId <string>

UniqueID of the placeholder setting to be removed.
Aliases
None
Required?
true
Position?
Named
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

Notes

Help Author: Adam Najmanowicz, Michael West

Examples

EXAMPLE 1

Remove all placeholder settings for "Default" device
1
Remove-PlaceholderSetting -Path master:\content\home -Device (Get-LayoutDevice "Default")
Copied!

EXAMPLE 2

Remove all placeholder settings with the "content" key.
1
Remove-PlaceholderSetting -Path master:\content\home -Key "content"
Copied!

Related Topics