powershell administration with sharepoint 2013 and sharepoint
TRANSCRIPT
PowerShell Administration with SharePoint 2013 and SharePoint OnlineCorey Roth@coreyroth
OFC-B328
Agenda & Key TakeawaysConfiguring PowerShell permissionsPowerShell for UpgradesUseful scriptsPowerShell with SharePoint OnlineUsing client object model with SPOPowerShell Tips
Getting StartedLaunch with:SharePoint 2013 Management Shell linkRun SharePoint.ps1 (Add-PSSnapin Microsoft.SharePoint.PowerShell)
AssumptionsYou have a basic understanding of PowerShellYou’re interested in doing “real stuff” with PSYou want to know more than the basics
PermissionsMany installations do not have permissions correctFarm / local administrator is NOT enoughDon’t use the farm account!PowerShell is more forgiving in SharePoint 2013Permissions for PowerShell are now configured OOTBDon’t forget to run as administrator
Granting permission to PowerShellGet-SPShellAdmin – determine access to PowerShellAdd-SPShellAdmin – add users to PowerShellMust execute for each content databaseGet-SPShellAdminAdd-SPShellAdmin –username sharepoint\sp_newadmin
$database = Get-SPContentDatabase MyContentDbAdd-SPShellAdmin –username domain\username –database $database
Add-SPShellAdminCorey Roth@coreyroth
Getting ready for Upgrade
Getting Ready for UpgradeTest-SPContentDatabase and Mount-SPContentDatabase still usedDeferred Site Collection Upgrade = New cmdletsTest-SPContentDatabase –Name Wss_Content –WebApplication http://servername
Mount-SPContentDatabase –Name Wss_Content –WebApplication http://servername
Content Database UpgradeCorey Roth@coreyroth
Deferred Site Collection UpgradesCmdlets to:Manage Health ChecksUpgradeRequest Evaluation Site CollectionsCopy
View upgrade status with Get-SPSite
Site Collection Health ChecksTest-SPSiteRuns Site Collection Health ChecksAll rules by default or specify specific rule
Repair-SPSiteAutomatically repairs all issues
Test-SPSite –Identity http://server/sitecollection
Repair-SPSite –Identity http://server/sitecollection
Upgrading Site CollectionsUpgrade-SPSiteStarts Upgrade Process on Site CollectionAlso resumes failed upgrades-Unthrottled – bypasses throttle limits-VersionUpgrade – used to upgrade from version 14
Upgrade-SPSite http://server/sitecollection -VersionUpgrade
Monitoring Upgrade StatusGet-SPSiteUpgradeSessionReports upgrade status for content db and site collectionUse with -ContentDatabase or -Site
Content Database requires a filter parameter:-HideWaiting-ShowCompleted-ShowFailed-ShowInProgressGet-SPSiteUpgradeSession –Site http://server/sitecolection
$database = Get-SPContentDatabase MyContentDbGet-SPSiteUpgradeSession –ContentDatabase $database -ShowInProgress
Upgrade Evaluation Site CollectionsRequest-SPUpgradeEvaluationSiteRequests an upgrade evaluation site collectionTarget URL auto-generated-Email – specify whether site collection owner and farm admin receive notification
Request-SPUpgradeEvaluationSite http://server/sitecollection
Copying Site CollectionsCopy-SPSiteCopies a site collection to a new URL-Identity – source URL-TargetUrl – destination URL-DestinationDatabase (optional) – name of new database
Copy-SPSite http://server/sitecollection -DestinationDatabase MyContentDb -TargetUrl http://server/sitecollection2
Site Collection UpgradeCorey Roth@coreyroth
When tools are needed
Windows PowerShell for SharePoint Command Builder
PowerShell Command Builder and ScriptsCorey Roth@coreyroth
Licensing
The ChallengeOnly some users need Enterprise featuresPreviously, no way to audit Enterprise useSharePoint 2013 License Checking feature helps
SharePoint 2013 LicensingMap license types to AD GroupsEnterpriseStandardProjectOfficeWebAppEdit
Standard users blocked from Enterprise featuresEnterprise Web Parts blocked from Add Web Part menuLicense Error on existing web parts
Disabled by defaultEnable with SP-EnableUserLicensing
License MappingGet-SPUserLicenseShows available license types (i.e.: Standard or Enterprise)
New-SPUserLicenseMappingMaps an AD group to a license typeAlso supports roles and claims-SecurityGroup – Active Directory Group-License – License type
Add-SPUserLicenseMappingAdds the new license mappingNo parameters, pipe input from New-SPUserLicenseMapping
Enable / Disable LicensingEnable-SPUserLicenseActivates license checking modeNo parameters necessary
Disable-SPUserLicenseDeactivates license checking modeNo parameters necessary
Enabling Licensing$standardusers = New-SPUserLicenseMapping –SecurityGroup “SharePoint Standard Users” –License Standard$enterpriseusers = New-SPUserLicenseMapping – SecurityGroup “SharePoint Enterprise Users” –License Enterprise
$standardusers | Add-NewSPUserLicenseMapping$enterpriseusers | Add-NewSPUserLicenseMapping
SP-EnableUserLicensing
License Mapping
Corey Roth@coreyroth
SharePoint Online
Getting Started with PowerShell and SPOInstall Windows PowerShell 3.0 from Windows Management Framework 3.0 (Windows 7)Already included with Windows 8 / 8.1 and SharePoint 2013
Install SharePoint Online Management Shellhttp://bit.ly/1hHX5qR
Identify your global administrator accountLaunch SharePoint Online Management ShellMicrosoft.Online.SharePoint.PowerShell.dll
PowerShell for SPO TipsRemember to use https instead of httpCommands have similar namesGet-SPO prefix
Global Administrator account requiredUse -NoWait for cmdlet to execute immediately
Connecting to SharePoint OnlineConnect-SPOServiceConnects to SharePoint Online-Url – URL to SharePoint Online tenant administration
i.e.: https://mytenant-admin.sharepoint.com-Credential – complete username of a global administrator
i.e.: [email protected]
Connect-SPOService –Url https://mytenant-admin.sharepoint.com –Credential [email protected]
What commands are available?Get-Command –Module Microsoft.Online.SharePoint.PowerShell
Working with Site CollectionsGet-SPOSiteReturns one or more site collections-Identity (optional) – URL of site collection-Limit (optional) – number of site collections to return
Default 200, ALL can be used-Filter (optional) – server side filtering using { }
Used in lieu of –IdentityNote case sensitive operators (-like, -notlike, -eq, -ne)
-Detailed – Returns non-default properties such as CompatibilityLevel
Get-SPOSiteGet-SPOSite -Detailed
Get-SPOSite –Identity https://mytenant.sharepoint.com
Get-SPOSite –Filter {Url -like “*term*}
Creating new Site CollectionsNew-SPOSiteCreates a site collection-Url – full URL of new site collection-Owner – full user name of site owner
i.e.: [email protected] – in MB-Template (Optional) – i.e.: STS#0
Get-SPOWebTemplate – returns all installed site templates-Title (Optional) – name of site collection
New-SPOSite -Url https://mytenant.sharepoint.com/sites/mynewsite -Owner [email protected] -StorageQuota 1000 -Title "My new site collection“ –Template STS#0
Deleting Site CollectionsRemove-SPOSiteMoves site collection to recycle bin-Identity – URL of site collectionSupports –confirm and -NoWait
Remove-SPOSite –Identity http://mytenant.sharepoint.com/sites/sitename -NoWait
Restoring Site CollectionsRestore-SPODeletedSiteRestores a site collection from the recycle bin-Identity – URL of site collection
Restore-SPODeletedSite –Identity http://mytenant.sharepoint.com/sites/sitename -NoWait
Working with UsersGet-SPOUser-Site – full URL of site collection-LoginName (Optional) – specific user account name
i.e.: [email protected]
Add-SPOUserAdds existing user to a SharePoint Group-Site – full URL of site collection-LoginName – specific user account name-Group – SharePoint group
Get-SPOUser -Site https://mytenant.sharepoint.com -LoginName [email protected] Add-SPOUser -Site https://mytenant.sharepoint.com -LoginName [email protected] -Group "Team Site Members“
PowerShell with SharePoint OnlineCorey Roth@coreyroth
What's missing?
PowerShell with the Client Object Model
Why CSOM?Many functions not available in PowerShell for SPOCSOM lets us do things such asWork with sitesCreate listsActivate features (even hidden ones)
Steps for using CSOM with PowerShellInstall CSOM libraries or run from SharePoint 2013Use Add-Type to reference CSOM libraries Microsoft.SharePoint.Client.dll Microsoft.SharePoint.Client.Runtime.dll
Create ClientContext objectAuthenticate to SPOLoad objectsCall ExecuteQuery()
PowerShell and CSOMCorey Roth@coreyroth
PowerShell Tips
Use PowerShell More EffectivelyUse the TAB key!Enumerators-Debug-WhatIf
Agenda & Key TakeawaysConfiguring PowerShell permissionsPowerShell for UpgradesUseful scriptsPowerShell with SharePoint OnlineUsing client object model with SPOPowerShell Tips
ResourcesSite Collection Upgrades with PowerShellhttp://bit.ly/Su5GTQ
Create and Manage SPO sites with PowerShellhttp://bit.ly/1mw0lZn
ResourcesLearning
Microsoft Certification & Training Resourceswww.microsoft.com/learning
msdnResources for Developers
http://microsoft.com/msdn
TechNetResources for IT Professionals
http://microsoft.com/technet
Sessions on Demandhttp://channel9.msdn.com/Events/TechEd
Complete an evaluation and enter to win!
Evaluate this session
Scan this QR code to evaluate this session.
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.