@antonytm/mcp-sitecore-server 1.0.0 → 1.2.0

package/dist/tools/powershell/documentation/new-explicitfilesource.md

@@ -0,0 +1,104 @@
+# New-ExplicitFileSource
+
+Creates new File source that can be added to a Sitecore package.
+
+## Syntax
+
+New-ExplicitFileSource \[-Name\] <String> \[-File <FileSystemInfo>\] \[-InstallMode <String>\]
+
+## Detailed Description
+
+Creates new File source that can be added to a Sitecore package. Folder provided as Root will be added as well as all of its content provided it matches the filters.
+
+© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
+
+## Parameters
+
+### -Name  <String>
+
+Name of the file source.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -File  <FileSystemInfo>
+
+Path to the file to be included. this can be automatically discovered if a stream of files is piped to the command.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | true \(ByValue\) |
+| Accept Wildcard Characters? | false |
+
+### -InstallMode  <String>
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+## Outputs
+
+The output type is the type of the objects that the cmdlet emits.
+
+* Sitecore.Install.Files.ExplicitFileSource 
+
+## Notes
+
+Help Author: Adam Najmanowicz, Michael West
+
+## Examples
+
+### EXAMPLE
+
+Following example creates a new package, adds content of the Console folder \(except the source files\) under the site folder saves it in the Sitecore Package folder + gives you an option to download the saved package.
+
+```powershell
+# Create package
+$package = New-Package "Packing in Powerful Ways";
+
+# Set package metadata
+$package.Sources.Clear();
+
+$package.Metadata.Author = "Adam Najmanowicz, Michael West";
+$package.Metadata.Publisher = "Powerful Ways";
+$package.Metadata.Version = "1.0";
+$package.Metadata.Readme = 'This text will be visible to people installing your package'
+
+# Add content of the Console folder (except the source files) located in the site folder to the package
+$source = Get-ChildItem -exclude *.cs -Path "$AppPath\Console" -Recurse -File | New-ExplicitFileSource -Name "Console Assets"
+$package.Sources.Add($source);
+
+# Save package
+Export-Package -Project $package -Path "$($package.Name)-$($package.Metadata.Version).zip" -Zip
+
+# Offer the user to download the package
+Download-File "$SitecorePackageFolder\$($package.Name)-$($package.Metadata.Version).zip"
+```
+
+## Related Topics
+
+* [Export-Package](export-package.md)
+* [Get-Package](get-package.md)
+* Import-Package
+* [Install-UpdatePackage](install-updatepackage.md)
+* [New-ExplicitItemSource](new-explicititemsource.md)
+* [New-FileSource](new-filesource.md)
+* [New-ItemSource](new-itemsource.md)
+* [New-Package](new-package.md)
+* [https://github.com/SitecorePowerShell/Console/](https://github.com/SitecorePowerShell/Console/) 
+* [https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/](https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/) 
+* [https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae](https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae) 
+* [https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd\_nCypVZSNkudGwPFRqf1na0b&index=7](https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd_nCypVZSNkudGwPFRqf1na0b&index=7) 
+

package/dist/tools/powershell/documentation/new-explicititemsource.md

@@ -0,0 +1,146 @@
+# New-ExplicitItemSource
+
+Creates new Explicit Item Source that can be added to a Sitecore package.
+
+## Syntax
+
+New-ExplicitItemSource \[-Item <Item>\] \[-Name\] <String> \[\[-SkipVersions\]\] \[-InstallMode <Undefined \| Overwrite \| Merge \| Skip \| SideBySide>\] \[-MergeMode <Undefined \| Clear \| Append \| Merge>\]
+
+## Detailed Description
+
+Creates new Item source that can be added to a Sitecore package. This source only includes items explicitly added to it and not their children.
+
+© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
+
+## Parameters
+
+### -Item  <Item>
+
+The item to be added to the source. If used in pipeline after e.g. Get-Item the source is created once all items are piped into it.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | true \(ByValue, ByPropertyName\) |
+| Accept Wildcard Characters? | false |
+
+### -Name  <String>
+
+Name of the item source.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -SkipVersions  <SwitchParameter>
+
+Add this parameter if you want to skip versions of the item from being included in the source and only include the version provided.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | 2 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -InstallMode  <InstallMode>
+
+Specifies what installer should do if the item already exists. Possible values:
+
+* Undefined - User will have to choose one of the below. But they probably don't really know what should be done so not a preferable option.
+* Overwrite - All versions of the old item are removed and replaced with all versions of the new item. This option basically replaces the old item with new one.
+* Merge - merge with existing item. How the item will be merged is defined with MergeMode parameter
+  * Skip - All versions remains unchanged. Other languages remains unchanged. All children remains unchanged.
+* SideBySide - all new item will be created. 
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -MergeMode  <MergeMode>
+
+Specifies what installer should do if the item already exists and InstallMode is specified as Merge. Possible values:
+
+* Undefined - User will have to choose one of the below. But they probably don't really know what should be done so not a preferable option.
+* Clear - All versions of the old item are removed and replaced with all versions of the new item. This option basically replaces the old item with new one. Other language versions \(those which are not in the package\) are removed but only for items which are in the package. All child items which are not in the package keep other language versions. All child items which are in the package are changed.
+* Append - All versions of the new item are added on top of versions of the previous item. This option allows for further manual merge because all history is preserved, so user can see what was changed. Other languages remains unchanged. All child items which are not in the package keep other language versions. All child items which are in the package are changed.
+* Merge - All versions with the same number in both packages are replaced with versions from installed package. All versions which are in the package but not in the target are added. All versions which are not in the package but are in the target remains unchanged. This option also preserves history, however it might overwrite some of the changes. Other languages remains unchanged. All child items which are in the package are changed. 
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| 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 
+
+## Outputs
+
+The output type is the type of the objects that the cmdlet emits.
+
+* Sitecore.Install.Items.ExplicitItemSource 
+
+## Notes
+
+Help Author: Adam Najmanowicz, Michael West
+
+## Examples
+
+### EXAMPLE
+
+Following example creates a new package, adds content/home item and all of its children to it and saves it in the Sitecore Package folder + gives you an option to download the saved package.
+
+```powershell
+$package = New-Package "Packing in Powerful Ways";
+
+# Set package metadata
+$package.Sources.Clear();
+
+$package.Metadata.Author = "Adam Najmanowicz, Michael West";
+$package.Metadata.Publisher = "Powerful Ways";
+$package.Metadata.Version = "1.0";
+$package.Metadata.Readme = 'This text will be visible to people installing your package'
+
+# Add content/home and all of its children to the package
+$source = Get-Item 'master:\content\home\*' | New-ExplicitItemSource -Name 'Home Page' -InstallMode Overwrite
+$package.Sources.Add($source);
+
+# Save package
+Export-Package -Project $package -Path "$($package.Name)-$($package.Metadata.Version).zip" -Zip
+
+# Offer the user to download the package
+Download-File "$SitecorePackageFolder\$($package.Name)-$($package.Metadata.Version).zip"
+```
+
+## Related Topics
+
+* [Export-Package](export-package.md)
+* [Get-Package](get-package.md)
+* Import-Package
+* [Install-UpdatePackage](install-updatepackage.md)
+* [New-ExplicitFileSource](new-explicitfilesource.md)
+* [New-FileSource](new-filesource.md)
+* [New-ItemSource](new-itemsource.md)
+* [New-Package](new-package.md)
+* [https://github.com/SitecorePowerShell/Console/](https://github.com/SitecorePowerShell/Console/) 
+* [https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/](https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/) 
+* [https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae](https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae) 
+* [https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd\_nCypVZSNkudGwPFRqf1na0b&index=7](https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd_nCypVZSNkudGwPFRqf1na0b&index=7) 
+

package/dist/tools/powershell/documentation/new-filesource.md

@@ -0,0 +1,128 @@
+# New-FileSource
+
+Creates new File source that can be added to a Sitecore package.
+
+## Syntax
+
+New-FileSource \[-Name\] <String> \[-Root\] <DirectoryInfo> \[\[-IncludeFilter\] <String>\] \[\[-ExcludeFilter\] <String>\] \[-InstallMode <String>\]
+
+## Detailed Description
+
+Creates new File source that can be added to a Sitecore package. Folder provided as Root will be added as well as all of its content provided it matches the filters.
+
+© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
+
+## Parameters
+
+### -Name  <String>
+
+Name of the file source.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Root  <DirectoryInfo>
+
+Root folder to include in the package
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 2 |
+| Default Value |  |
+| Accept Pipeline Input? | true \(ByValue\) |
+| Accept Wildcard Characters? | false |
+
+### -IncludeFilter  <String>
+
+Filter that defines which files will be included.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | 3 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -ExcludeFilter  <String>
+
+Filter that defines which files will NOT be included.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | 4 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -InstallMode  <String>
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+## Outputs
+
+The output type is the type of the objects that the cmdlet emits.
+
+* Sitecore.Install.Files.FileSource 
+
+## Notes
+
+Help Author: Adam Najmanowicz, Michael West
+
+## Examples
+
+### EXAMPLE
+
+Following example creates a new package, adds content of the Console folder under the site folder saves it in the Sitecore Package folder + gives you an option to download the saved package.
+
+```powershell
+# Create package
+$package = New-Package "Packing in Powerful Ways";
+
+# Set package metadata
+$package.Sources.Clear();
+
+$package.Metadata.Author = "Adam Najmanowicz, Michael West";
+$package.Metadata.Publisher = "Powerful Ways";
+$package.Metadata.Version = "1.0";
+$package.Metadata.Readme = 'This text will be visible to people installing your package'
+
+# Add content of the Console folder in the site folder to the package
+$source = New-FileSource -Name "Console Assets" -Root "$AppPath\Console"
+$package.Sources.Add($source);
+
+# Save package
+Export-Package -Project $package -Path "$($package.Name)-$($package.Metadata.Version).zip" -Zip
+
+# Offer the user to download the package
+Download-File "$SitecorePackageFolder\$($package.Name)-$($package.Metadata.Version).zip"
+```
+
+## Related Topics
+
+* [Export-Package](export-package.md)
+* [Get-Package](get-package.md)
+* Import-Package
+* [Install-UpdatePackage](install-updatepackage.md)
+* [New-ExplicitFileSource](new-explicitfilesource.md)
+* [New-ExplicitItemSource](new-explicititemsource.md)
+* [New-ItemSource](new-itemsource.md)
+* [New-Package](new-package.md)
+* [https://github.com/SitecorePowerShell/Console/](https://github.com/SitecorePowerShell/Console/) 
+* [https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/](https://blog.najmanowicz.com/2011/12/19/continuous-deployment-in-sitecore-with-powershell/) 
+* [https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae](https://gist.github.com/AdamNaj/f4251cb2645a1bfcddae) 
+* [https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd\_nCypVZSNkudGwPFRqf1na0b&index=7](https://www.youtube.com/watch?v=60BGRDNONo0&list=PLph7ZchYd_nCypVZSNkudGwPFRqf1na0b&index=7) 
+

package/dist/tools/powershell/documentation/new-itemacl.md

@@ -0,0 +1,175 @@
+# New-ItemAcl
+
+Creates a new access rule for use with Set-ItemAcl and Add-ItemAcl cmdlets.
+
+## Syntax
+
+New-ItemAcl \[-Identity\] <AccountIdentity> \[-AccessRight\] <String> \[-PropagationType\] <Unknown \| Descendants \| Entity \| Any> \[-SecurityPermission\] <NotSet \| AllowAccess \| DenyAccess \| AllowInheritance \| DenyInheritance>
+
+## Detailed Description
+
+Creates a new access rule for use with Set-ItemAcl and Add-ItemAcl cmdlets.
+
+© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
+
+## Parameters
+
+### -Identity  <AccountIdentity>
+
+User name including domain for which the access rule is being created. If no domain is specified - 'sitecore' will be used as the default domain.
+
+Specifies the Sitecore user by providing one of the following values.
+
+```powershell
+Local Name
+    Example: adam
+Fully Qualified Name
+    Example: sitecore\adam
+```
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -AccessRight  <String>
+
+The access right to grand or deny. Well known rights are:
+
+* field:read - "Field Read" - controls whether an account can read a specific field on an item..
+* field:write - "Field Write" - controls whether an account can update a specific field on an item.
+* item:read - "Read" - controls whether an account can see an item in the content tree and/or on the published Web site, including all of its properties and field values.
+* item:write - "Write" - controls whether an account can update field values. The write access right requires the read access right and field read and field write access rights for individual fields \(field read and field write are allowed by default\).
+* item:rename - "Rename" - controls whether an account can change the name of an item. The rename access right requires the read access right.
+* item:create - "Create" - controls whether an account can create child items. The create access right requires the read access right.
+* item:delete - "Delete" - Delete right for items. controls whether an account can delete an item. The delete access right requires the read access right
+
+  Important!
+
+  The Delete command also deletes all child items, even if the account has been denied Delete
+
+  rights for one or more of the subitems.
+
+* item:admin - "Administer" - controls whether an account can configure access rights on an item. The administer access right requires the read and write access rights.
+* language:read - "Language Read" - controls whether a user can read a specific language version of items.
+* language:write - "Language Write" - controls whether a user can update a specific language version of items.
+* site:enter - controls whether a user can access a specific site.
+* insert:show - "Show in Insert" - Determines if the user can see the insert option
+* workflowState:delete - "Workflow State Delete" - controls whether a user can delete items which are currently associated with a specific workflow state.
+* workflowState:write - "Workflow State Write" - controls whether a user can update items which are currently associated with a specific workflow state.
+* workflowCommand:execute - "Workflow Command Execute" - — controls whether a user is shown specific workflow commands.
+* profile:customize - "Customize Profile Key Values" - The right to input out of range values of profile keys, that belong to this profile.
+* bucket:makebucket - "Create Bucket" - convert item to bucket.
+* bucket:unmake - "Revert Bucket" - convert item back from bucket.
+* remote:fieldread - "Field Remote Read" - Field Read right for remoted clients. 
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 2 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -PropagationType  <PropagationType>
+
+The PropagationType enumeration determines which items will be granted the access right.
+
+* Any - the item and all items inheriting
+* Descendants - applies rights to inheriting children only
+* Entity - applies right to the item only 
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 3 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -SecurityPermission  <SecurityPermission>
+
+The SecurityPermission determines whether to grant \(allow\) or deny the access right, and deny or allow inheritance of the right.
+
+* AllowAccess - 
+* DenyAccess - 
+* AllowInheritance - 
+* DenyInheritance - 
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 4 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+## Outputs
+
+The output type is the type of the objects that the cmdlet emits.
+
+* Sitecore.Security.AccessControl.AccessRule 
+
+## Notes
+
+Help Author: Adam Najmanowicz, Michael West
+
+## Examples
+
+### EXAMPLE 1
+
+Creates an access rule that allows the "sitecore\adam" user to delete the item to which it will be applied and all of its childre
+
+```powershell
+PS master:\> New-ItemAcl -AccessRight item:delete -PropagationType Any -SecurityPermission AllowAccess -Identity "sitecore\adam"
+
+Account           AccessRight    PermissionType   PropagationType  SecurityPermission
+-------           -----------    --------------   ---------------  ------------------
+sitecore\admin    item:delete    Access           Any              AllowAccess
+```
+
+### EXAMPLE 2
+
+Allows the "sitecore\adam" user to delete the Home item and all of its children. Denies the "sitecore\mikey" user reading the descendants of the Home item. ;P The security info is created prior to adding it to the item. The item is delivered to the Add-ItemAcl from the pipeline and returned to the pipeline after processing due to the -PassThru parameter. The security information is added to the previously existing security qualifiers.
+
+```powershell
+$acl1 = New-ItemAcl -AccessRight item:delete -PropagationType Any -SecurityPermission AllowAccess -Identity "sitecore\adam"
+$acl2 = New-ItemAcl -AccessRight item:read -PropagationType Descendants -SecurityPermission DenyAccess -Identity "sitecore\mikey"
+Get-Item -Path master:\content\home | Add-ItemAcl -AccessRules $acl1, $acl2 -PassThru
+
+Name   Children Languages                Id                                     TemplateName
+----   -------- ---------                --                                     ------------
+Home   False    {en, ja-JP, de-DE, da}   {110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9} Sample Item
+```
+
+### EXAMPLE 3
+
+Allows the "sitecore\adam" user to delete the Home item and all of its children. Denies the "sitecore\mikey" user reading the descendants of the Home item. ;P The security info is created prior to setting it to the item. The item is delivered to the Set-ItemAcl from the pipeline and returned to the pipeline after processing due to the -PassThru parameter. Any previuous security information on the item is removed.
+
+```powershell
+$acl1 = New-ItemAcl -AccessRight item:delete -PropagationType Any -SecurityPermission AllowAccess -Identity "sitecore\adam"
+$acl2 = New-ItemAcl -AccessRight item:read -PropagationType Descendants -SecurityPermission DenyAccess -Identity "sitecore\mikey"
+Get-Item -Path master:\content\home | Set-ItemAcl -AccessRules $acl1, $acl2 -PassThru
+
+Name   Children Languages                Id                                     TemplateName
+----   -------- ---------                --                                     ------------
+Home   False    {en, ja-JP, de-DE, da}   {110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9} Sample Item
+```
+
+## Related Topics
+
+* [https://github.com/SitecorePowerShell/Console/](https://github.com/SitecorePowerShell/Console/) 
+* [Add-ItemAcl](add-itemacl.md)
+* [Clear-ItemAcl](clear-itemacl.md)
+* [Get-ItemAcl](get-itemacl.md)
+* [Set-ItemAcl](set-itemacl.md)
+* [Test-ItemAcl](test-itemacl.md)
+* [https://sdn.sitecore.net/upload/sitecore6/security\_administrators\_cookbook\_a4.pdf](https://sdn.sitecore.net/upload/sitecore6/security_administrators_cookbook_a4.pdf) 
+* [https://sdn.sitecore.net/upload/sitecore6/61/security\_reference-a4.pdf](https://sdn.sitecore.net/upload/sitecore6/61/security_reference-a4.pdf) 
+* [https://sdn.sitecore.net/upload/sitecore6/64/content\_api\_cookbook\_sc64\_and\_later-a4.pdf](https://sdn.sitecore.net/upload/sitecore6/64/content_api_cookbook_sc64_and_later-a4.pdf) 
+* [https://www.sitecore.net/learn/blogs/technical-blogs/john-west-sitecore-blog/posts/2013/01/sitecore-security-access-rights.aspx](https://www.sitecore.net/learn/blogs/technical-blogs/john-west-sitecore-blog/posts/2013/01/sitecore-security-access-rights.aspx) 
+* [https://briancaos.wordpress.com/2009/10/02/assigning-security-to-items-in-sitecore-6-programatically/](https://briancaos.wordpress.com/2009/10/02/assigning-security-to-items-in-sitecore-6-programatically/) 
+

package/dist/tools/powershell/documentation/new-itemclone.md

@@ -0,0 +1,139 @@
+# New-ItemClone
+
+Creates a new item clone based on the item provided.
+
+## Syntax
+
+New-ItemClone \[-Item\] <Item> -Destination <Item> \[-Name <String>\] \[-Recurse\]
+
+New-ItemClone \[-Path\] <String> -Destination <Item> \[-Name <String>\] \[-Recurse\]
+
+New-ItemClone -Id <String> \[-Database <String>\] -Destination <Item> \[-Name <String>\] \[-Recurse\]
+
+## Detailed Description
+
+Creates a new item clone based on the item provided.
+
+© 2010-2019 Adam Najmanowicz, Michael West. All rights reserved. Sitecore PowerShell Extensions
+
+## Parameters
+
+### -Destination  <Item>
+
+Parent item under which the clone should be created.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Name  <String>
+
+Name of the item clone.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Recurse  <SwitchParameter>
+
+Add the parameter to clone thw whole branch rather than a single item.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Item  <Item>
+
+The item to be cloned.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | true \(ByValue, ByPropertyName\) |
+| Accept Wildcard Characters? | false |
+
+### -Path  <String>
+
+Path to the item to be cloned.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | 1 |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Id  <String>
+
+Id of the item to be cloned
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | true |
+| Position? | named |
+| Default Value |  |
+| Accept Pipeline Input? | false |
+| Accept Wildcard Characters? | false |
+
+### -Database  <String>
+
+Database of the item to be cloned if item is specified through its ID.
+
+| Aliases |  |
+| :--- | :--- |
+| Required? | false |
+| 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 
+
+## Outputs
+
+The output type is the type of the objects that the cmdlet emits.
+
+* Sitecore.Data.Items.Item 
+
+## Notes
+
+Help Author: Adam Najmanowicz, Michael West
+
+## Examples
+
+### EXAMPLE
+
+Clone /sitecore/content/home/ under /sitecore/content/new-target/ with the "New Home" name.
+
+```powershell
+PS master:\> $newTarget = Get-Item master:\content\new-target\
+PS master:\> New-ItemClone -Path master:\content\home -Destination $newTarget -Name "New Home"
+```
+
+## Related Topics
+
+* [Get-ItemClone](get-itemclone.md)
+* [ConvertFrom-ItemClone](convertfrom-itemclone.md)
+* New-Item
+* [https://github.com/SitecorePowerShell/Console/](https://github.com/SitecorePowerShell/Console/) 
+* [https://github.com/SitecorePowerShell/Console/issues/218](https://github.com/SitecorePowerShell/Console/issues/218) 
+