Expected Behavior
Add-Rendering returns the RenderingDefinition object associated with the newly added rendering. This is helpful for cases where dynamic placeholders are in use, and the unique id of the Instance is leveraged to determine a generated placeholder value.
Actual Behavior
Add-Rendering does not currently return a value. This makes it difficult to dynamically build pages via SPE. The specific use case I am processing is building pages during content migration.
Current Work-around
If you leverage the -Index parameter for Add-Rendering and Get-Rendering, then you can get to the correct instance to grab the unique id:
Add-Rendering -Item $item -PlaceHolder $placeholderPath -Instance $accordionSectionRendering -DataSource $datasource.ID -FinalLayout -Index $renderingIndex
$accordionSectionInstance = Get-Rendering -Item $item -Placeholder $placeholderPath -FinalLayout -Index $renderingIndex
$renderingIndex++
Proposed Feature
Add support for -PassThru switch on the Add-Rendering method. Switch will allow user to capture the RenderingDefinition instance of the newly added rendering in a variable and use it to calculate any dynamic placeholder that was generated by that rendering:
$rendering = Add-Rendering -Item $item -PlaceHolder $placeholderPath -Instance accordionSectionRendering -DataSource $datasource.ID -FinalLayout -PassThru
Please include the version number of SPE and Sitecore.
Expected Behavior
Add-Renderingreturns theRenderingDefinitionobject associated with the newly added rendering. This is helpful for cases where dynamic placeholders are in use, and the unique id of the Instance is leveraged to determine a generated placeholder value.Actual Behavior
Add-Renderingdoes not currently return a value. This makes it difficult to dynamically build pages via SPE. The specific use case I am processing is building pages during content migration.Current Work-around
If you leverage the
-Indexparameter forAdd-RenderingandGet-Rendering, then you can get to the correct instance to grab the unique id:Proposed Feature
Add support for
-PassThruswitch on theAdd-Renderingmethod. Switch will allow user to capture theRenderingDefinitioninstance of the newly added rendering in a variable and use it to calculate any dynamic placeholder that was generated by that rendering:Please include the version number of SPE and Sitecore.
Tested issue with clean install of Sitecore and the latest available version of SPE.
Asked questions on the Sitecore Slack Chat channel.
Reviewed questions and answers on the Sitecore Stack Exchange.