In addition to the system and hardware requirements, the following must be installed on the VitalSigns workstation/server.
- Powershell 4.0
- .NET Framwork 4.5.1
To set the appropriate permissions and settings for monitoring, please view the Server Requirements and Client Requirements pages.
The administration account must have the following:
- Active Directory credentials
- Member of Exchange Administrators group is ideal
- Requires the right to run remote Powershell commands
Open a Windows PowerShell session as administrator.
On the Server:
Configure the station to receive remote commands:
Enable-PSRemoting –Force
Enable Credential Security Service Provider (CREDSSP) authentication on the local server:
Enable-WSManCredSSP –Role Server
- To increase the maximum number of PS shells per user to 25 and to increase the max memory per shell to 600MB
- Enter winrm set winrm/config/winrs '@{MaxShellsPerUser="25"}'
Enter winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="600"}'
- To Return all users who have the SharePoint_Shell_Access role
- Enter Get-SPShellAdmin
- Enter Get-SPShellAdmin
- If the desired user is not listed, you can add a specified service account to the SharePoint_Shell_Access role for a given database
- Enter Add-SPShellAdmin -UserName Domain\Username -Database (Get-SPContentDatabase -Identity “ContentDatabaseName”)
- Replace Domain\Username with the desired user
Replace ContentDatabaseName with the desired Content Database
Note: You will need to run this command for all content databases for the user(s) who need access. To grant access to all Content Databases enter Get-SPDatabase | Add-SPShellAdmin DOMAIN\UserName- To Return all users who have the SharePoint_Shell_Access role and confirm the desired user is now listed
- Enter Get-SPShellAdmin
- Enter Get-SPShellAdmin
- To open the permissions dialog box
- Enter Set-PSSessionConfiguration -Name Microsoft.PowerShell32 –ShowSecurityDescriptorUI
- Add the desired user(s) and ensure they have Read and Execute permissions
- Click OK to save the changes
- Follow step 7a to ensure the permissions were successfully applied
- Once the server requirements have been met, please view our Client Requirements page.
On the Client:
- To enable Credential Security Service Provider (CREDSSP) authentication on the local client machine
- Enter Enable-WSManCredSSP -Role client -DelegateComputer “SharePointServerName”
- Enter Enable-WSManCredSSP -Role client -DelegateComputer “SharePointServerName”
- To open a credentials prompt box
- Enter $cred=get-Credential
- Enter an administrators account (or the admin account you worked with in the Server Requirements) to run the rest of the PowerShell commands with this account
- To create a new remote session to the SharePointServerName using the authentication type CredSSP and the credentials previously entered
Enter $s=new-PSsession “SharePointServerName” - authentication credssp -credential $cred
If this fails with an "access denied" error, re-run step 7a on the server (Server Requirements) to enable configuration of the x64 PowerShell (i.e. Set-PSSessionConfiguration -Name Microsoft.PowerShell32 –ShowSecurityDescriptorUI)- To load the SharePoint snap-in to the current session to allow SharePoint related scripts to be executed
- Enter Invoke-Command -Session $s -ScriptBlock {Add-PSSnapin Microsoft.SharePoint.PowerShell;}
- Enter Invoke-Command -Session $s -ScriptBlock {Add-PSSnapin Microsoft.SharePoint.PowerShell;}
- To return all content databases in your SharePoint farm (which ensures you have access)
- Enter Invoke-Command -Session $s -ScriptBlock {get-SPContentDatabase}
- Enter Invoke-Command -Session $s -ScriptBlock {get-SPContentDatabase}
- To return all SharePoint service instances (which ensures you have access)
- Enter Invoke-Command -Session $s -ScriptBlock {get-spserviceinstance}
- Enter Invoke-Command -Session $s -ScriptBlock {get-spserviceinstance}
- To attempt to use the PS Session to ensure connectivity between the two machines
- Enter Enter-PSSession -session $s
You will now see the server(s) name in [ ] PS: c:\users\someuser\documents (Example: [sp2013-app.fabrikaminc.local]: PS C:\Users\adamb\Documents>)