New-UsingBlock
New-UsingBlock.
Syntax
New-UsingBlock [-InputObject] <IDisposable> [-ScriptBlock] <ScriptBlock>
Detailed Description
The
New-UsingBlock command disposes of the provided input object after the specified scriptblock completes execution. You may find the data returned by the scriptblock is contained within the following object System.Collections.ObjectModel.Collection1[[System.Management.Automation.PSObject, System.Management.Automation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]`. This helps when multiple objects are returned and is known behavior.© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
Parameters
-InputObject <IDisposable>
Object that should be disposed after the Script block is executed.
Aliases
​
Required?
true
Position?
1
Default Value
​
Accept Pipeline Input?
false
Accept Wildcard Characters?
false
-ScriptBlock <ScriptBlock>
Script to be executed within the "Using" context.
Aliases
​
Required?
true
Position?
2
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.
- System.IDisposable
Outputs
The output type is the type of the objects that the cmdlet emits.
- void
Notes
Help Author: Adam Najmanowicz, Michael West
Examples
EXAMPLE 1
Assuming all items under /sitecore/content/home have both 'Title' and 'MetaTitle' fields... Using New-UsingBlock to bulk update items under /sitecore/Content/ to have their 'MetaTitle' field to be equal to the 'Title' field
1
New-UsingBlock (New-Object Sitecore.Data.BulkUpdateContext) {
2
foreach ( $item in (Get-ChildItem -Path master:\Content\Home -Recurse -WithParent) ) {
3
$item."MetaTitle" = $item.Title
4
}
5
}
Copied!
EXAMPLE 2
Using New-UsingBlock to perform a test with UserSwitcher - checking whether an anonymous user can change a field The test should end up showing the error as below and the Title should not be changed!
1
$anonymous = Get-User -Identity "extranet\Anonymous"
2
$testItem = Get-Item -Path master:\Content\Home
3
​
4
New-UsingBlock (New-Object Sitecore.Security.Accounts.UserSwitcher $anonymous) {
5
$testItem.Title = "If you can see this title it means that anonymous users can change this item!"
6
}
7
​
8
​
9
New-UsingBlock : Exception setting "Title": "Exception calling "Modify" with "3" argument(s): "The current user does not have write access to this item. User: extranet\Anonymous, Item: Home ({110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9})""
10
At line:3 char:1
11
+ New-UsingBlock (New-Object Sitecore.Security.Accounts.UserSwitcher $a ...
12
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13
+ CategoryInfo : NotSpecified: (:) [New-UsingBlock], SetValueInvocationException
14
+ FullyQualifiedErrorId : ScriptSetValueRuntimeException,Spe.Commands.Data.NewUsingBlockCommand
Copied!
Related Topics
Last modified 2yr ago