SharePointDSC

3.8.0

This DSC module is used to deploy and configure SharePoint Server 2013, 2016 and 2019, and covers a wide range of areas including web apps, service apps and farm configuration.

Minimum PowerShell version

4.0

There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name SharePointDSC -RequiredVersion 3.8.0

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Author(s)

DSC Community

Copyright

Copyright the DSC Community contributors. All rights reserved.

Owners

Tags

DesiredStateConfiguration DSC DSCResourceKit DSCResource

Cmdlets

Invoke-SPDscCommand Get-SPDscInstalledProductVersion Get-SPDscContentService Rename-SPDscParamValue Add-SPDscUserToLocalAdmin Remove-SPDscUserToLocalAdmin Test-SPDscObjectHasProperty Test-SPDscRunAsCredential Test-SPDscUserIsLocalAdmin Test-SPDscParameterState Test-SPDscIsADUser Test-SPDscRunningAsFarmAccount Set-SPDscObjectPropertyIfValuePresent Get-SPDscUserProfileSubTypeManager Get-SPDscOSVersion Get-SPDscRegistryKey Resolve-SPDscSecurityIdentifier Get-SPDscFarmProductsInfo Get-SPDscFarmVersionInfo Convert-SPDscADGroupIDToName Convert-SPDscADGroupNameToID

DSCResources

SPAccessServiceApp SPAccessServices2010 SPAlternateUrl SPAntivirusSettings SPAppCatalog SPAppDomain SPAppManagementServiceApp SPAppStoreSettings SPAuthenticationRealm SPBCSServiceApp SPBlobCacheSettings SPCacheAccounts SPConfigWizard SPContentDatabase SPDatabaseAAG SPDesignerSettings SPDiagnosticLoggingSettings SPDiagnosticsProvider SPDistributedCacheClientSettings SPDistributedCacheService SPExcelServiceApp SPFarm SPFarmAdministrators SPFarmPropertyBag SPFarmSolution SPFeature SPHealthAnalyzerRuleState SPIncomingEmailSettings SPInfoPathFormsServiceConfig SPInstall SPInstallLanguagePack SPInstallPrereqs SPIrmSettings SPLogLevel SPMachineTranslationServiceApp SPManagedAccount SPManagedMetadataServiceApp SPManagedMetadataServiceAppDefault SPManagedPath SPMinRoleCompliance SPOfficeOnlineServerBinding SPOutgoingEmailSettings SPPasswordChangeSettings SPPerformancePointServiceApp SPPowerPointAutomationServiceApp SPProductUpdate SPProjectServerAdditionalSettings SPProjectServerADResourcePoolSync SPProjectServerGlobalPermissions SPProjectServerGroup SPProjectServerLicense SPProjectServerPermissionMode SPProjectServerServiceApp SPProjectServerTimeSheetSettings SPProjectServerUserSyncSettings SPProjectServerWssSettings SPPublishServiceApplication SPQuotaTemplate SPRemoteFarmTrust SPSearchAuthoritativePage SPSearchContentSource SPSearchCrawlerImpactRule SPSearchCrawlMapping SPSearchCrawlRule SPSearchFileType SPSearchIndexPartition SPSearchManagedProperty SPSearchMetadataCategory SPSearchResultSource SPSearchServiceApp SPSearchServiceSettings SPSearchTopology SPSecureStoreServiceApp SPSecurityTokenServiceConfig SPSelfServiceSiteCreation SPServiceAppPool SPServiceAppProxyGroup SPServiceAppSecurity SPServiceIdentity SPServiceInstance SPSessionStateService SPShellAdmins SPSite SPSitePropertyBag SPSiteUrl SPStateServiceApp SPSubscriptionSettingsServiceApp SPTimerJobState SPTrustedIdentityTokenIssuer SPTrustedIdentityTokenIssuerProviderRealms SPTrustedRootAuthority SPTrustedSecurityTokenIssuer SPUsageApplication SPUserProfileProperty SPUserProfileSection SPUserProfileServiceApp SPUserProfileServiceAppPermissions SPUserProfileSyncConnection SPUserProfileSyncService SPVisioServiceApp SPWeb SPWebAppAuthentication SPWebAppBlockedFileTypes SPWebAppClientCallableSettings SPWebAppGeneralSettings SPWebApplication SPWebApplicationAppDomain SPWebApplicationExtension SPWebAppPeoplePickerSettings SPWebAppPermissions SPWebAppPolicy SPWebAppPropertyBag SPWebAppProxyGroup SPWebAppSiteUseAndDeletion SPWebAppSuiteBar SPWebAppThrottlingSettings SPWebAppWorkflowSettings SPWordAutomationServiceApp SPWorkflowService SPWorkManagementServiceApp

Dependencies

This module has no dependencies.

Release Notes

## [3.8.0] - 2020-02-27

### Added

- SharePointDsc
 - Added automatic release with a new CI pipeline
 - Updated PULL_REQUEST_TEMPLATE.md to match DSC standard
 - Prepared Conceptual Help and Wiki Content generation
- SPAzureAccessControlServiceAppProxy
 - Added new resource to create Azure Access Control Service Application Proxy
- SPExcelServiceApp
 - Documentation update for SharePoint 2016/2019 deprecation.
- SPInstallPrereqs
 - Documentation update for SharePoint 2019 offline install parameters.
- SPFarm
 - Added possibility to set application credential key.
- SPOAppPrincipalMgmtServiceAppProxy
 - Added new resource to create SharePoint Online Application Principal
   Management Service Application Proxy
- SPTrustedSecurityTokenIssuer
 - Fixed RegisteredIssuerNameRealm not applied if specified.
- SPUserProfileProperty
 - Added IsReplicable property.

### Changed

- SharePointDsc
 - Updated all resources and Invoke-SPDscCommand function to automatically
   load Utils module, which broke with the new CI
 - Extended Convert-SPDscHashtableToString function to support complex types
   in arrays and the CIMInstance type
- SPConfigWizard
 - Updated checks in Set method to make sure the resource also runs when
   a language pack is installed
- SPContentDatabase
 - Updated DatabaseServer parameter to support null value
- SPSearchIndexPartition
 - Updated documentation to specifically mention that each index partition
   requires its own dedicated RootDirectory
- SPUserProfileServiceApp
 - Implemented ability to fix incorrectly linked proxy groups
- SPWebApplicationExtension
 - Forced the conversion of Paths to string

### Deprecated

- None

### Removed

- None

### Fixed

- SharePointDsc
 - Corrected schema.mof files of SPSubscriptionSettingServiceApp and
   SPPasswordChangeSettings resources, which caused failed Wiki generation
- SPSearchContentSource
 - Add CrawlVirtualServers and CrawlSites CrawlSetting for SharePoint content
   sources.
- SPSubscriptionSettingServiceApp
 - Corrected incorrect information in Readme file
- SPUserProfileProperty
 - Fixed typo in user profile property test for IsSearchable.

### Security

- None

## [3.7.0.0] - 2019-10-30

### Added

- None

### Changed

- None

### Deprecated

- None

### Removed

- None

### Fixed

- SPConfigWizard
 - Fixed issue with incorrect check for upgrade status of server
- SPDistributedCacheService
 - Improved error message for inclusion of server name into ServerProvisionOrder
   parameters when Present or change to Ensure Absent
- SPFarm
 - Removed SingleServer as ServerRole, since this is an invalid role.
 - Handle case where null or empty CentralAdministrationUrl is passed in
 - Move CentralAdministrationPort validation into parameter definition
   to work with ReverseDsc
 - Add NotNullOrEmpty parameter validation to CentralAdministrationUrl
 - Fixed error when changing developer dashboard display level.
 - Add support for updating Central Admin Authentication Method
- SPFarmSolution
 - Fix for Web Application scoped solutions.
- SPInstall
 - Fixes a terminating error for sources in weird file shares
 - Corrected issue with incorrectly detecting SharePoint after it
   has been uninstalled
 - Corrected issue with detecting a paused installation
- SPInstallLanguagePack
 - Fixes a terminating error for sources in weird file shares
- SPInstallPrereqs
 - Fixes a terminating error for sources in weird file shares
- SPProductUpdate
 - Fixes a terminating error for sources in weird file shares
 - Corrected incorrect farm detection, added in earlier bugfix
- SPSite
 - Fixed issue with incorrectly updating site OwnerAlias and
   SecondaryOwnerAlias
- SPWebAppAuthentication
 - Fixes issue where Test method return false on NON-US OS.

### Security

- None

## [3.6.0.0] - 2019-08-07

### Added

- SPTrustedSecurityTokenIssuer
 - New resource for configuring OAuth trusts

### Changed

- None

### Deprecated

- None

### Removed

- None

### Fixed

- SharePointDsc generic
 - Added new launch actions to vscode to allow code coverage reports for
   the current unit test file.
- SPFarm
 - Moved check for CentralAdministrationUrl is HTTP to Set method,
   to prevent issues with ReverseDsc
- SPInstall
 - Updated error code checks to force reboot.
- SPProductUpdate
 - Fixes an issue using ShutdownServices when no Farm is available.
- SPTrustedRootAuthority
 - Fixes issue where Set method throws an error because the
   parameter CertificateFilePath is not read correctly.

### Security

- None

For older change log history see the [historic changelog](HISTORIC_CHANGELOG.md).

Version History

Version Downloads Last updated
4.8.0-previe... 7 7/9/2021
4.8.0-previe... 6 6/27/2021
4.7.0 6,386 6/10/2021
4.6.1-previe... 2 6/10/2021
4.6.1-previe... 13 4/12/2021
4.6.1-previe... 4 4/9/2021
4.6.1-previe... 4 4/8/2021
4.6.0 11,301 4/2/2021
4.6.0-previe... 4 4/1/2021
4.6.0-previe... 9 3/25/2021
4.5.1 10,063 2/5/2021
4.5.1-previe... 5 2/4/2021
4.5.0 1,205 1/30/2021
4.5.0-previe... 13 1/8/2021
4.5.0-previe... 9 12/19/2020
4.4.1-previe... 6 11/26/2020
4.4.1-previe... 6 11/18/2020
4.4.0 15,596 11/14/2020
4.4.0-previe... 3 11/14/2020
4.4.0-previe... 3 11/13/2020
4.4.0-previe... 5 11/11/2020
4.4.0-previe... 2 11/11/2020
4.3.1-previe... 5 10/23/2020
4.3.0 10,125 9/30/2020
4.3.0-previe... 1 9/30/2020
4.3.0-previe... 1 9/25/2020
4.3.0-previe... 1 9/25/2020
4.2.1-previe... 12 7/30/2020
4.2.1-previe... 3 7/29/2020
4.2.0 19,633 6/14/2020
4.2.0-previe... 3 6/13/2020
4.1.0 1,422 6/10/2020
4.1.0-previe... 3 6/9/2020
4.1.0-previe... 7 6/2/2020
4.1.0-previe... 10 5/11/2020
4.0.1-previe... 6 5/5/2020
4.0.0 6,759 4/28/2020
4.0.0-previe... 9 4/28/2020
4.0.0-previe... 9 4/28/2020
4.0.0-previe... 12 3/31/2020
4.0.0-previe... 5 3/27/2020
3.9.0-previe... 7 3/19/2020
3.8.0 (current version) 11,665 2/27/2020
3.8.0-previe... 7 2/25/2020
3.8.0-previe... 9 2/18/2020
3.8.0-previe... 5 2/18/2020
3.8.0-previe... 13 1/24/2020
3.8.0-previe... 5 1/17/2020
3.8.0-previe... 7 1/16/2020
3.7.0.0 23,181 10/30/2019
3.6.0.0 15,597 8/12/2019
3.5.0.0 9,462 6/26/2019
3.4.0.0 9,756 5/15/2019
3.3.0.0 16,437 4/3/2019
3.2.0.0 34,084 2/20/2019
3.1.0.0 4,174 11/29/2018
3.0.0.0 1,470 11/12/2018
2.6.0.0 2,738 10/25/2018
2.5.0.0 10,051 9/5/2018
2.4.0.0 10,167 7/25/2018
2.3.0.0 3,587 6/13/2018
2.2.0.0 8,044 3/22/2018
2.1.0.0 2,995 2/8/2018
2.0.0.0 2,674 12/20/2017
1.9.0.0 11,842 10/5/2017
1.8.0.0 7,266 7/12/2017
1.7.0.0 1,278 5/31/2017
1.6.0.0 12,667 3/8/2017
1.5.0.0 1,465 12/14/2016
1.4.0.0 676 11/2/2016
1.3.0.0 862 9/21/2016
1.2.0.0 484 8/10/2016
1.1.0.0 585 6/29/2016
1.0.0.0 281 6/7/2016
Show less