sitecorepowershell/book

Sitecore PowerShell Extensions - The Book

book's Issues

Add detail on execution context in the ISE

The execute button had additional options. Expand on these and when to use.

Install-UpdatePackage "Update" parameter does not update _Standard values

Hello,

We have used the below command to install TDS items, however we noticed our _Standard values are not getting deployed.
Install-UpdatePackage -Path $package -UpgradeAction Upgrade -InstallMode Update

The below was the message appearing in the TDS log:
WARN:Field: '[s]Header Description Text[/s]' ([s]{A3253692-ED0F-4931-B9CA-0AE10803D866}[/s])
Item path: '[s]/sitecore/templates/abc/Base/UI/Shared/xyz/__Standard Values[/s]'
Item ID: '[s]{729901BF-551F-4330-A125-A83B57A7B595}[/s]'
Language: '[s]en[/s]'
Version: '[s]1[/s]'
The field has been modified from '[s][/s]' to '[s]Description Here.[/s]'.
The field value will not be changed.

We were able to get it work if it manually install the TDS through the update installation wizard.

Moreover we were able to get it work if we change the parameter from Update to Install.
Install-UpdatePackage -Path $package -UpgradeAction Upgrade -InstallMode Install

Hence just wanted to understand the difference between the two parameters as well as the impact of changing it.

Thanks
Ritesh

No New-Item documentation

The New-Item command exists, I've seen it work in PS scripts, and it is described on the Working With Items Readme, but I can't find page dedicated to New-Item and all of the available switches.

Migrate content from gitbook to github

This will allow us to use github for sharing content.

Web API documentation improvement

docs url: https://doc.sitecorepowershell.com/web-api.html

Following example URL
http://remotesitecore/-/script/v2/master/homeanddescendants?user=admin&password=b
is no longer valid.

I know this is an example but someone might get stuck like I did.

value admin is no longer valid for pattern in WildcardMatch method

I had to provide following user via query string: sitecore\admin and this should be default one right now.

Note: Converted from Console issue.

Link is 404ing

Book/modules/integration-points/reports/README.md

Line 5 in d566fdd

We've built quite a few reports, many similar to the [Advanced System Report](https://github.com/SitecorePowerShell/Book/tree/9c7126d7a38df6ef372e8baef52f9a02baabd550/modules/integration-points/reports/[https:/marketplace.sitecore.net/en/Modules/A/Advanced/_System/_Reporter.aspx]) \(ASR\) module.

Add examples to book for re-linking items

Based off of issue Console 717 and https://gist.github.com/AdamNaj/354660183bea96a4ceb06cf1a9a92f30#file-Relink-Test-ps1

Add url examples to the book.

$site = [Sitecore.Sites.SiteContextFactory]::GetSiteContext("usa")
$url = New-UsingBlock (New-Object Sitecore.Sites.SiteContextSwitcher $site) {
    $pageItem = Get-Item -Path "master:" -Id "{50BE527C-7241-4613-A7A9-20D0217B264B}"
    [Sitecore.Links.LinkManager]::GetItemUrl($pageItem)
}

$url = New-UsingBlock (New-Object Sitecore.Sites.SiteContextSwitcher $site) {
    $mediaItem = Get-Item -Path "master:" -Id "{CBE06C33-59DE-4B34-968D-19EBA886BC84}"
    [Sitecore.Resources.Media.MediaManager]::GetMediaUrl($mediaItem)
}

New-Package command missing from book

Reported by @kamsar

in https://doc.sitecorepowershell.com/appendix/commands/Get-Package.html, under Related Topics there's a link for New-Package that goes to a raw md file. I noticed New-package is also not listed in the main navigation. But the md file renders okay on Github - not sure what's wrong with it.

Content Editor warning code is executed for latest version(not for selected)

Narrative:

I as Content Editor want Sitecore Powershell Warnings to be executed for the selected item version.

Steps to reproduce on 'Elevated Unlock' as an example:

1. Create 2 Sitecore users: user1 and user2.
2. Assign sitecore\Sitecore Local Administrators role to these users
3. Login as user1
4. Create some item
5. Create 5 versions of this item
6. Switch to 2 version. (Version number doesn't matter. It should be not the latest one)
7. Lock this item version for editing
8. Logout
9. Login as user2
10. Navigate to item create on step 4
11. Switch to 2 version. (version from step 6)

Expected result:
Warning 'Elevated Unlock' should be shown. Message 'Use elevated privileges to unlock the current item.' should be present and 'Unlock' button should be available to unlock this version.
Actual result:
Warning 'Elevated Unlock' is absent

Investigation result:
Enable rule takes current item using $item = Get-Item -Path "." code, which ignores the version.
However, I looked on Spe.Integrations.Pipelines.ContentEditorWarningScript implementation and it looks like only path is transferred to SPE, via scriptSession.SetItemLocationContext. That is why the fix should contain 2 parts:

1. Passing item version to script session
2. Getting item version from context and execute 'Enable Rule' using that version

Add details on granting access to reports

Question has come up a few times.

http://sitecore.stackexchange.com/questions/4095/sitecore-powershell-extensions-reports-authorization/4109#4109

Set-User without -Email property is removing email address from profile

Hello -

The email address field value is getting deleted from the user profile when using Set-User.

Note that in the code below, the -Email property is not set in Set-User, which is not a required property .
'foo' does exist as a custom property on the profile.

`$users = Get-User -Filter $userFilter
foreach ( $user in $users )
{
$profile = $user.Profile
$identity = $profile.Username

Set-User -Identity $identity -CustomProperties @{ "foo" = "bar" }
}`

This occurs in SPE 5.1.
Thanks (again) for this awesome module for Sitecore.

FieldsToCopy missing from Set-ItemTemplate documentation

Changes are detailed here:
SitecorePowerShell/Console#847

Thank you @coreyasmith for pointing it out.

Screenshots for the book

Add Rendering Sample scripts

Here is a useful script for caching

https://sitecorebrasil.wordpress.com/2017/04/28/updating-renderings-properties-using-sitecore-powershell-extensions/