Skip to content

Commit eba89fb

Browse files
authored
Update overview.md
Added additional introductory content and Moved SharePoint Server specific information to sharepoint-server-cmdlets.md
1 parent 4b21999 commit eba89fb

File tree

1 file changed

+3
-39
lines changed

1 file changed

+3
-39
lines changed

sharepoint/docs-conceptual/overview.md

Lines changed: 3 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -4,39 +4,13 @@ Microsoft PowerShell is a command-line shell and scripting language that provide
44

55
By default, Powershell is located at the following path: <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.
66

7+
PowerShell can be used by authorized admins to perform a wide variety of tasks in SharePoint on-premises and SharePoint Online. Microsoft provides the cmdlets used for these 2 systems and the Patterns and Practices (PnP) group has created an additional set of modules that provide many additional capabilities.
8+
79
For a list of SharePoint Server on-premises cmdlets, see [SharePoint Server cmdlets](sharepoint-server\sharepoint-server-cmdlets.md)
810

911
For a list of SharePoint Online cmdlets, see [SharePoint Online cmdlets](sharepoint-online\sharepoint-online-cmdlets.md)
1012

11-
## Accessing PowerShell for SharePoint Server ##
12-
13-
After you install SharePoint Server, applicable PowerShell cmdlets are available in the SharePoint 2016 Management Shell. You can manage most aspects of SharePoint Server in the SharePoint Management Shell. You can create new site collections, web applications, user accounts, service applications, proxies, and more. Commands that you type in the SharePoint Management Shell return SharePoint objects that are based on the Microsoft .NET Framework. You can apply these objects as input to subsequent commands or store the objects in local variables for later use.
14-
15-
With the SharePoint Management Shell, you do not have to register the snap-in that contains the cmdlets. Registration of the Microsoft.SharePoint.PowerShell.dll module for SharePoint Server cmdlets is automatic, as a result of the **Add-PSSnapin Microsoft.SharePoint.PowerShell** line in the SharePoint.ps1 file that is located in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration, where version "15" equals SharePoint Server 2013, and version "16" equals SharePoint Server 2016. To use the PowerShell console, you must register this snap-in manually.
16-
17-
Whether you use the SharePoint Management Shell or the PowerShell console, you can also load additional snap-ins. For more information, see [Customizing Profiles](https://technet.microsoft.com/en-us/library/2008.10.windowspowershell.aspx).
18-
19-
**NOTE:** The SharePoint Management Shell and the PowerShell console also differ in the use of the **ReuseThread** option, which defines how the threading model is used. The SharePoint Management Shell's use is defined by this line, {Host.Runspace.ThreadOptions = "ReuseThread"}, which is in the SharePoint.ps1 file. For more information, see [PS Thread Options](https://docs.microsoft.com/en-us/dotnet/api/system.management.automation.runspaces.psthreadoptions?redirectedfrom=MSDN&view=powershellsdk-1.1.0).
20-
21-
## Permissions ##
22-
23-
#### On-Premises ####
24-
25-
Before you can use the Add-SPShellAdmin cmdlet to grant permissions for users to run SharePoint Server cmdlets, verify that you meet all of the following minimum requirements:
26-
27-
* You must have membership in the **securityadmin** fixed server role on the SQL Server instance.
28-
* You must have membership in the **securityadmin** fixed server role on the SQL Server instance.
29-
* You must be a member of the Administrators group on the server on which you are running the PowerShell cmdlet.
30-
31-
**NOTE:** If these permissions are not satisfied, contact your Setup administrator or SQL Server administrator to request these permissions.
32-
33-
For additional information about PowerShell permissions, see [Add-SPShellAdmin](../sharepoint-ps/sharepoint-server/Add-SPShellAdmin.md).
34-
35-
If you do not have membership in the **SharePoint_Shell_Access** role or **WSS_Admin_WPG** local group, use the **Add-SPShellAdmin** cmdlet to add the **WSS_Admin_WPG** group in all front-end web servers in the SharePoint farm and the **SharePoint_Shell_Access** role. If the SQL Server database does not have a **SharePoint_Shell_Access** role, the role is automatically created when you run the **Add-SPShellAdmin** cmdlet. After you run the **Add-SPShellAdmin** cmdlet, users can run SharePoint PowerShell cmdlets in a multiple-server farm environment.
36-
37-
**NOTE:** When you install SharePoint Server, the user account from which you run the installation is granted the appropriate permissions to run PowerShell cmdlets. If any users have not been added to run a PowerShell cmdlet, you can use the **Add-SPShellAdmin** cmdlet to add them.
38-
39-
To see a list of all of the **SPShellAdmin** cmdlets, from a PowerShell command prompt, type _Get-Command -Noun SPShellAdmin_.
13+
For a list of the SharePoint PnP cmdlets, see [SharePoint PnP cmdlets] (sharepoint-pnp\sharepoint-pnp-cmdlets.md)
4014

4115
#### SharePoint Online ####
4216

@@ -47,16 +21,6 @@ Verify that you have the following administrative permissions:
4721

4822
**IMPORTANT:** You can use a specific group of PowerShell with SharePoint Online. For more information, see [Office 365 PowerShell for SharePoint Online](https://technet.microsoft.com/en-us/library/fp161362(v=office.16).aspx).
4923

50-
51-
## Scripts and execution policies ##
52-
53-
Although you can use Microsoft PowerShell to perform a single administrative task, you can also use a script to automate a series of tasks. A script is a text file that contains one or more Microsoft PowerShell commands. Microsoft PowerShell scripts have a .ps1 file name extension.
54-
55-
To run scripts, the minimum required execution policy for SharePoint Server is **RemoteSigned**, although the default policy for PowerShell is Restricted. If the policy is left as Restricted, the SharePoint Management Shell will change the policy for PowerShell to RemoteSigned. This means that you must select **Run as administrator** to start the SharePoint Management Shell with elevated administrative permission. This change will apply to all PowerShell sessions. For more information, see [ExecutionPolicy Enumeration](https://docs.microsoft.com/en-us/dotnet/api/microsoft.powershell.executionpolicy?redirectedfrom=MSDN&view=powershellsdk-1.1.0).
56-
57-
For additional information about scripts and execution policies, see [about_scripts](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_scripts?view=powershell-5.1&viewFallbackFrom=powershell-Microsoft.PowerShell.Core) and  [about_execution_policies](https://technet.microsoft.com/library/dd347641.aspx).
58-
59-
6024
## Learning PowerShell ##
6125

6226
There are several PowerShell learning resources for SharePoint IT professionals.

0 commit comments

Comments
 (0)