New release: SharePointDsc v4.6 is here!

Published 04-02-2021 08:36 AM 741 Views
Microsoft

It is a Good Friday to release a new version of SharePointDsc, so v4.6 has been published to the PowerShell Gallery. This release fixes a bunch of issues, but it also includes a changes to the requirements: ReverseDsc is no longer required. We removed this requirement so it is not required to install the module if you only deploy changes to SharePoint environments.

 

Instead the Export-SPConfiguration cmdlet now checks if the module is present and throws an error when it is not. That way, you only need ReverseDsc when you want to export an existing configuration.

 

You can find the SharePointDsc v4.6 in the PowerShell Gallery!

 

NOTE: We can always use additional help in making SharePointDsc even better. So if you are interested in contributing to SharePointDsc, check-out the open issues in the issue list, check-out this post in our Wiki or leave a comment on this blog post.

 

Improvement/Fixes in v4.6:

Added
  • SharePointDsc
    • Export-SPDscDiagnosticData cmdlet to create a diagnostic package which can easily be shared for troubleshooting
  • ReverseDsc
    • Added a check in Export-SPConfiguration/Start-SharePointDSCExtract to check if ReverseDsc is present or not. Show instructions if it isn't
    • Added DocIcon to export GUI
    • Renamed export cmdlet to Export-SPConfiguration, to match Microsoft365DSC naming. Added old Start-SharePointDSCExtract as alias
Changed
  • ReverseDsc
    • Made the export GUI logic more dynamic
  • SPFarmAdministrators
    • Added check to see if a central admin site is returned and stop if it isn't
  • SPManagedMetaDataServiceApp
    • Added check to see if a central admin site is returned and stop if it isn't
  • SPSite
    • Added check to see if a central admin site is returned and stop if it isn't
Fixed
  • SPAccessServiceApp, SPAccessServices2010, SPAppManagementServiceApp, SPBCSServiceApp, SPExcelServiceApp, SPMachineTranslationServiceApp, SPManagedMetadataServiceApp, SPPerformancePointServiceApp, SPPowerPointAutomationServiceApp, SPProjectServerServiceApp, SPPublishServiceApplication, SPSearchCrawlRule, SPSearchFileType, SPSearchServiceApp, SPSecureStoreServiceApp, SPServiceAppSecurity, SPSubscriptionSettingsServiceApp, SPUsageApplication, SPUserProfileProperty, SPUserProfileSection, SPUserProfileServiceApp, SPUserProfileSyncConnection, SPUserProfileSyncService, SPVisioServiceApp, SPWordAutomationServiceApp, SPWorkManagementServiceApp
    • Fixed issue with the Name parameter of Get-SPServiceApplication, which is case sensitive
  • SPExcelServiceApp
    • Fixed issue where PSBoundParameters was used multiple times, but manipulated at an early stage, breaking all subsequent usages
  • SPInstallLanguagePack
    • Fixed issue in the Norwegian Language Pack detection
  • SPSearchManagedProperty
    • Fixed issue where setting Searchable=True resulted in an error
  • SPSearchResultSource
    • Clarified the use of ScopeName and ScopeUrl with SSA as ScopeName and added examples
  • SPUserProfileServiceApp
    • Fixed issue where MySiteHostLocation was return from Get method including port number, which causes the Test method to fail
  • SPWebAppAuthentication
    • Fix issue in Get method to return Null when zone does not exist. That way the Test and Set method can detect a non-existent zone and throw a proper error.
  • SPWordAutomation
    • Fixed issue where the resource never went into desired state when using AddToDefault
Removed
  • SharePointDsc
    • Removed the ReverseDsc dependency for the SharePointDsc module since the module is only required when performing an export
 

A huge thanks to everybody who submitted issues and all that support this project. It wasn’t possible without all of your help!

 

For more information about how to install SharePointDsc, check our Readme.md.

 

Let us know in the comments what you think of this release! If you find any issues, please submit them in the issue list on GitHub.

 

Happy SharePointing!!

%3CLINGO-SUB%20id%3D%22lingo-sub-2251010%22%20slang%3D%22en-US%22%3ENew%20release%3A%20SharePointDsc%20v4.6%20is%20here!%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2251010%22%20slang%3D%22en-US%22%3E%3CP%3EIt%20is%20a%20Good%20Friday%20to%20release%20a%20new%20version%20of%20SharePointDsc%2C%20so%20v4.6%20has%20been%20published%20to%20the%20PowerShell%20Gallery.%20This%20release%20fixes%20a%20bunch%20of%20issues%2C%20but%20it%20also%20includes%20a%20changes%20to%20the%20requirements%3A%20ReverseDsc%20is%20no%20longer%20required.%20We%20removed%20this%20requirement%20so%20it%20is%20not%20required%20to%20install%20the%20module%20if%20you%20only%20deploy%20changes%20to%20SharePoint%20environments.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EInstead%20the%20Export-SPConfiguration%20cmdlet%20now%20checks%20if%20the%20module%20is%20present%20and%20throws%20an%20error%20when%20it%20is%20not.%20That%20way%2C%20you%20only%20need%20ReverseDsc%20when%20you%20want%20to%20export%20an%20existing%20configuration.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EYou%20can%20find%20the%20%3CA%20title%3D%22SharePointDsc%20v4.6%22%20href%3D%22https%3A%2F%2Fwww.powershellgallery.com%2Fpackages%2FSharePointDsc%2F4.6.0%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noreferrer%22%3ESharePointDsc%20v4.6%3C%2FA%3E%20in%20the%20PowerShell%20Gallery!%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3ENOTE%3A%3C%2FSTRONG%3E%20We%20can%20always%20use%20additional%20help%20in%20making%20SharePointDsc%20even%20better.%20So%20if%20you%20are%20interested%20in%20contributing%20to%20SharePointDsc%2C%20check-out%20the%20open%20issues%20in%20the%20%3CA%20title%3D%22Issue%20List%22%20href%3D%22https%3A%2F%2Fgithub.com%2Fdsccommunity%2FSharePointDsc%2Fissues%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Eissue%20list%3C%2FA%3E%2C%20check-out%20%3CA%20title%3D%22Contributing%20to%20SharePointDsc%22%20href%3D%22https%3A%2F%2Fgithub.com%2Fdsccommunity%2FSharePointDsc%2Fwiki%2FContributing%2520to%2520SharePointDsc%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Ethis%20post%3C%2FA%3E%20in%20our%20Wiki%20or%20leave%20a%20comment%20on%20this%20blog%20post.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EImprovement%2FFixes%20in%20v4.6%3A%3C%2FP%3E%0A%3CDIV%3E%0A%3CDIV%3E%3CSTRONG%3EAdded%3C%2FSTRONG%3E%3C%2FDIV%3E%0A%3CUL%3E%0A%3CLI%3E%3CSPAN%3ESharePointDsc%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EExport-SPDscDiagnosticData%26nbsp%3Bcmdlet%26nbsp%3Bto%26nbsp%3Bcreate%26nbsp%3Ba%26nbsp%3Bdiagnostic%26nbsp%3Bpackage%26nbsp%3Bwhich%26nbsp%3Bcan%20easily%26nbsp%3Bbe%26nbsp%3Bshared%26nbsp%3Bfor%26nbsp%3Btroubleshooting%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3EReverseDsc%3CUL%3E%0A%3CLI%3EAdded%26nbsp%3Ba%26nbsp%3Bcheck%26nbsp%3Bin%26nbsp%3BExport-SPConfiguration%2FStart-SharePointDSCExtract%26nbsp%3Bto%26nbsp%3Bcheck%26nbsp%3Bif%20ReverseDsc%20is%20present%20or%20not.%20Show%20instructions%20if%20it%20isn't%3C%2FLI%3E%0A%3CLI%3EAdded%26nbsp%3BDocIcon%26nbsp%3Bto%26nbsp%3Bexport%26nbsp%3BGUI%3C%2FLI%3E%0A%3CLI%3ERenamed%26nbsp%3Bexport%26nbsp%3Bcmdlet%26nbsp%3Bto%26nbsp%3BExport-SPConfiguration%2C%26nbsp%3Bto%26nbsp%3Bmatch%26nbsp%3BMicrosoft365DSC%26nbsp%3Bnaming.%20Added%26nbsp%3Bold%26nbsp%3BStart-SharePointDSCExtract%20as%20alias%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CDIV%3E%3CSTRONG%3EChanged%3C%2FSTRONG%3E%3C%2FDIV%3E%0A%3CUL%3E%0A%3CLI%3EReverseDsc%3CUL%3E%0A%3CLI%3EMade%26nbsp%3Bthe%26nbsp%3Bexport%26nbsp%3BGUI%26nbsp%3Blogic%26nbsp%3Bmore%26nbsp%3Bdynamic%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPFarmAdministrators%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EAdded%26nbsp%3Bcheck%26nbsp%3Bto%26nbsp%3Bsee%26nbsp%3Bif%26nbsp%3Ba%26nbsp%3Bcentral%26nbsp%3Badmin%26nbsp%3Bsite%26nbsp%3Bis%26nbsp%3Breturned%26nbsp%3Band%26nbsp%3Bstop%26nbsp%3Bif%26nbsp%3Bit%26nbsp%3Bisn't%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPManagedMetaDataServiceApp%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EAdded%26nbsp%3Bcheck%26nbsp%3Bto%26nbsp%3Bsee%26nbsp%3Bif%26nbsp%3Ba%26nbsp%3Bcentral%26nbsp%3Badmin%26nbsp%3Bsite%26nbsp%3Bis%26nbsp%3Breturned%26nbsp%3Band%26nbsp%3Bstop%26nbsp%3Bif%26nbsp%3Bit%26nbsp%3Bisn't%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3ESPSite%3CUL%3E%0A%3CLI%3EAdded%26nbsp%3Bcheck%26nbsp%3Bto%26nbsp%3Bsee%26nbsp%3Bif%26nbsp%3Ba%26nbsp%3Bcentral%26nbsp%3Badmin%26nbsp%3Bsite%26nbsp%3Bis%26nbsp%3Breturned%26nbsp%3Band%26nbsp%3Bstop%26nbsp%3Bif%26nbsp%3Bit%26nbsp%3Bisn't%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CDIV%3E%3CSTRONG%3EFixed%3C%2FSTRONG%3E%3C%2FDIV%3E%0A%3CUL%3E%0A%3CLI%3E%3CSPAN%3ESPAccessServiceApp%2C%20SPAccessServices2010%2C%20SPAppManagementServiceApp%2C%20SPBCSServiceApp%2C%26nbsp%3B%3C%2FSPAN%3ESPExcelServiceApp%2C%20SPMachineTranslationServiceApp%2C%20SPManagedMetadataServiceApp%2C%20SPPerformancePointServiceApp%2C%20SPPowerPointAutomationServiceApp%2C%20SPProjectServerServiceApp%2C%20SPPublishServiceApplication%2C%20SPSearchCrawlRule%2C%20SPSearchFileType%2C%20SPSearchServiceApp%2C%20SPSecureStoreServiceApp%2C%20SPServiceAppSecurity%2C%20SPSubscriptionSettingsServiceApp%2C%20SPUsageApplication%2C%20SPUserProfileProperty%2C%20SPUserProfileSection%2C%20SPUserProfileServiceApp%2C%20SPUserProfileSyncConnection%2C%20SPUserProfileSyncService%2C%20SPVisioServiceApp%2C%20SPWordAutomationServiceApp%2C%20SPWorkManagementServiceApp%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bwith%26nbsp%3Bthe%26nbsp%3BName%26nbsp%3Bparameter%26nbsp%3Bof%26nbsp%3BGet-SPServiceApplication%2C%26nbsp%3Bwhich%26nbsp%3Bis%26nbsp%3Bcase%20sensitive%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3ESPExcelServiceApp%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bwhere%26nbsp%3BPSBoundParameters%26nbsp%3Bwas%26nbsp%3Bused%26nbsp%3Bmultiple%26nbsp%3Btimes%2C%26nbsp%3Bbut%26nbsp%3Bmanipulated%26nbsp%3Bat%26nbsp%3Ban%26nbsp%3Bearly%20stage%2C%20breaking%20all%20subsequent%20usages%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3ESPInstallLanguagePack%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bin%26nbsp%3Bthe%26nbsp%3BNorwegian%26nbsp%3BLanguage%26nbsp%3BPack%26nbsp%3Bdetection%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPSearchManagedProperty%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bwhere%26nbsp%3Bsetting%26nbsp%3BSearchable%3DTrue%26nbsp%3Bresulted%26nbsp%3Bin%26nbsp%3Ban%26nbsp%3Berror%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3ESPSearchResultSource%3CUL%3E%0A%3CLI%3EClarified%26nbsp%3Bthe%26nbsp%3Buse%26nbsp%3Bof%26nbsp%3BScopeName%26nbsp%3Band%26nbsp%3BScopeUrl%26nbsp%3Bwith%26nbsp%3BSSA%26nbsp%3Bas%26nbsp%3BScopeName%26nbsp%3Band%26nbsp%3Badded%26nbsp%3Bexamples%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPUserProfileServiceApp%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bwhere%26nbsp%3BMySiteHostLocation%26nbsp%3Bwas%26nbsp%3Breturn%26nbsp%3Bfrom%26nbsp%3BGet%26nbsp%3Bmethod%26nbsp%3Bincluding%26nbsp%3Bport%26nbsp%3Bnumber%2C%20which%20causes%20the%20Test%20method%20to%20fail%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPWebAppAuthentication%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EFix%26nbsp%3Bissue%26nbsp%3Bin%26nbsp%3BGet%26nbsp%3Bmethod%26nbsp%3Bto%26nbsp%3Breturn%26nbsp%3BNull%26nbsp%3Bwhen%26nbsp%3Bzone%26nbsp%3Bdoes%26nbsp%3Bnot%26nbsp%3Bexist.%26nbsp%3BThat%26nbsp%3Bway%26nbsp%3Bthe%26nbsp%3BTest%26nbsp%3Band%20Set%26nbsp%3Bmethod%26nbsp%3Bcan%26nbsp%3Bdetect%26nbsp%3Ba%26nbsp%3Bnon-existent%20zone%20and%20throw%20a%20proper%20error.%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3CLI%3E%3CSPAN%3ESPWordAutomation%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3EFixed%26nbsp%3Bissue%26nbsp%3Bwhere%26nbsp%3Bthe%26nbsp%3Bresource%26nbsp%3Bnever%26nbsp%3Bwent%26nbsp%3Binto%26nbsp%3Bdesired%26nbsp%3Bstate%26nbsp%3Bwhen%26nbsp%3Busing%26nbsp%3BAddToDefault%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CDIV%3E%3CSTRONG%3ERemoved%3C%2FSTRONG%3E%3C%2FDIV%3E%0A%3CUL%3E%0A%3CLI%3E%3CSPAN%3ESharePointDsc%3C%2FSPAN%3E%3CUL%3E%0A%3CLI%3ERemoved%26nbsp%3Bthe%26nbsp%3BReverseDsc%26nbsp%3Bdependency%26nbsp%3Bfor%26nbsp%3Bthe%26nbsp%3BSharePointDsc%26nbsp%3Bmodule%26nbsp%3Bsince%26nbsp%3Bthe%26nbsp%3Bmodule%20is%20only%20required%20when%20performing%20an%20export%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FDIV%3E%0A%3CDIV%3E%26nbsp%3B%3C%2FDIV%3E%0A%3CP%3EA%20huge%20thanks%20to%20everybody%20who%20submitted%20issues%20and%20all%20that%20support%20this%20project.%20It%20wasn%E2%80%99t%20possible%20without%20all%20of%20your%20help!%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EFor%20more%20information%20about%20how%20to%20install%20SharePointDsc%2C%20check%20our%20%3CA%20title%3D%22ReadMe%22%20href%3D%22https%3A%2F%2Fgithub.com%2Fdsccommunity%2FSharePointDsc%2Fblob%2Fmaster%2FREADME.md%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EReadme.md%3C%2FA%3E.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ELet%20us%20know%20in%20the%20comments%20what%20you%20think%20of%20this%20release!%20If%20you%20find%20any%20issues%2C%20please%20submit%20them%20in%20the%20%3CA%20title%3D%22Issue%20List%22%20href%3D%22https%3A%2F%2Fgithub.com%2Fdsccommunity%2FSharePointDsc%2Fissues%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Eissue%20list%20on%20GitHub%3C%2FA%3E.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EHappy%20SharePointing!!%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-2251010%22%20slang%3D%22en-US%22%3E%3CP%3ESharePoint%20v4.6%20has%20been%20released%20today.%20This%20release%20fixes%20a%20lot%20of%20issues%20discovered%20in%20SharePointDsc%20over%20the%20past%20weeks.%20A%20big%20change%20is%20that%20the%20ReverseDsc%20module%20is%20no%20longer%20a%20requirement%20if%20you%20only%20use%20the%20module%20for%20deploying%20changes.%20Of%20course%20exporting%20configurations%20still%20requires%20the%20ReverseDsc%20module.%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-2251010%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3ERelease%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3Esharepoint%202013%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3ESharePoint%202016%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3ESharePoint%202019%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Co-Authors
Version history
Last update:
‎Apr 02 2021 08:36 AM
Updated by: