In addition to the system and hardware requirements, the following must be installed on the VitalSigns workstation/server.
- Powershell 4.0
- .NET Framwork Framework 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
To set the appropriate permissions and settings for monitoring, please view the Server Requirements and Client Requirements sections below:
Tip |
---|
Open a Windows PowerShell session as administrator. |
Server Requirements:
Configure the station to receive remote commands:
No Format Enable-PSRemoting –Force
Enable Credential Security Service Provider (CREDSSP) authentication on the local server:
No Format Enable-WSManCredSSP –Role Server
- To increase
Increase the maximum number of PS shells per user to 25
and to increase the max memory per shell to 600MBEnter winrm set:
Enter winrm setNo Format winrm set winrm/config/winrs '@{MaxShellsPerUser="25"}'
Increase the max memory per shell to 600MB:
No Format winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="600"}'
- To
Return all users who have the SharePoint_Shell_Access role:
EnterNo Format Get-SPShellAdmin
Highlight If the desired user is not listed, you can add a specified service account to the SharePoint_Shell_Access role for a given database:
Note Replace Domain\Username with the desired user and ContentDatabaseName with the desired content database.
No Format Enter Add-SPShellAdmin -UserName Domain\Username -Database (Get-SPContentDatabase -Identity “ContentDatabaseName”)
- Replace Domain\Username with the desired user
Info You will need to run this command for all content databases for the user(s) who need access. To Highlight To grant access to all Content Databases enter : No Format 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:
EnterNo Format Get-SPShellAdmin
- To open
Open the permissions dialog box and enter:
No Format 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 ourreview the Client Requirements
page.
Replace ContentDatabaseName with the desired Content Database
Note:Client Requirements:
- 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>)