Merge branch 'master' of https://github.com/PowerShell/SharePointDsc …

…into release-2.4

Modules/SharePointDsc/SharePointDsc.psd1

@@ -115,7 +115,7 @@ PrivateData = @{
     PSData = @{
 
         # Tags applied to this module. These help with module discovery in online galleries.
-        Tags = @('DesiredStateConfiguration', 'DSC', 'DSCResourceKit', 'DSCResource', 'preview')
+        Tags = @('DesiredStateConfiguration', 'DSC', 'DSCResourceKit', 'DSCResource')
 
         # A URL to the license for this module.
         LicenseUri = 'https://github.com/PowerShell/SharePointDsc/blob/master/LICENSE'

Modules/SharePointDsc/en-US/about_SPAccessServiceApp.help.txt

@@ -0,0 +1,91 @@
+.NAME
+    SPAccessServiceApp
+
+# Description
+
+    **Type:** Distributed
+
+    This resource is responsible for creating Access Services Application instances
+    within the local SharePoint farm. The resource will provision and configure the
+    Access Services Service Application.
+
+    The default value for the Ensure parameter is Present. When not specifying this
+    parameter, the service application is provisioned.
+
+.PARAMETER Name
+    Key - string
+    The name of the service application
+
+.PARAMETER ApplicationPool
+    Required - string
+    The name of the application pool to run the service app in
+
+.PARAMETER DatabaseServer
+    Required - string
+    The name of the database server to host Access Services databases
+
+.PARAMETER Ensure
+    Write - string
+    Allowed values: Present, Absent
+    Present ensures service app exists, absent ensures it is removed
+
+.PARAMETER InstallAccount
+    Write - String
+    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
+
+
+.EXAMPLE
+    This example shows how to deploy Access Services 2013 to the local SharePoint farm.
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAccessServiceApp AccessServices
+            {
+                Name                 = "Access Services Service Application"
+                ApplicationPool      = "SharePoint Service Applications" 
+                DatabaseServer       = "SQL.contoso.local\SQLINSTANCE"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+
+.EXAMPLE
+
+    This example shows how to remove a specific Access Services 2013 from the local 
+    SharePoint farm. Because Application pool and database server are both required
+    parameters, but are not acutally needed to remove the app, any text value can 
+    be supplied for these as they will be ignored. 
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAccessServiceApp AccessServices
+            {
+                Name                 = "Access Services Service Application"
+                ApplicationPool      = "n/a" 
+                DatabaseServer       = "n/a"
+                Ensure               = "Absent"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+

Modules/SharePointDsc/en-US/about_SPAlternateUrl.help.txt

@@ -0,0 +1,117 @@
+.NAME
+    SPAlternateUrl
+
+# Description
+
+    **Type:** Distributed
+
+    This resource is used to define an alternate access mapping URL for a specified
+    web application. These can be assigned to specific zones for each web
+    application. Alternatively a URL can be removed from a zone to ensure that it
+    will remain empty and have no alternate URL.
+
+    The default value for the Ensure parameter is Present. When not specifying this
+    parameter, the setting is configured.
+
+    ## Central Administration
+
+    To select the Central Administration site, use the following command to retrieve
+    the correct web application name:
+    (Get-SPWebApplication -IncludeCentralAdministration | Where-Object {
+         $_.IsAdministrationWebApplication
+     }).DisplayName
+
+    To update the existing Default Zone AAM for Central Administration (e.g. to
+    implement HTTPS), use the above command to retrieve the web application name
+    (by default, it will be "SharePoint Central Administration v4") and specify
+    "Default" as the Zone. If you wish to add AAM's instead, you may use the other
+    zones to do so.
+
+    Using SPAlternateUrl to update the Default Zone AAM for Central Administration
+    will update the AAM in SharePoint as well as the CentralAdministrationUrl value
+    in the registry. It will not, however, update bindings in IIS. It is recommended
+    to use the xWebsite resource from the xWebAdministration module to configure the
+    appropriate bindings in IIS.
+
+.PARAMETER WebAppName
+    Key - String
+    The name of the web application to apply the alternate URL to
+
+.PARAMETER Zone
+    Key - String
+    Allowed values: Default, Intranet, Extranet, Custom, Internet
+    The Zone to use for the alternate URL
+
+.PARAMETER Url
+    Key - String
+    The new alternate URL
+
+.PARAMETER Internal
+    Write - Boolean
+    Specifies if the URL has to be configured as internal
+
+.PARAMETER Ensure
+    Write - string
+    Allowed values: Present, Absent
+    Present ensures the URL is set for this zone on this web app, Absent ensures it is removed
+
+.PARAMETER InstallAccount
+    Write - String
+    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
+
+
+.EXAMPLE
+    This example shows how to add a new alternate URL to a specific web application
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAlternateUrl CentralAdminAAM
+            {
+                WebAppName           = "SharePoint - www.domain.com80"
+                Zone                 = "Intranet"
+                Url                  = "https://admin.sharepoint.contoso.com"
+                Internal             = $false
+                Ensure               = "Present"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+
+.EXAMPLE
+    This example shows how to remove an alternate URL from a specified zone for a specific
+    web application.
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAlternateUrl CentralAdminAAM
+            {
+                WebAppName           = "SharePoint - www.domain.com80"
+                Zone                 = "Intranet"
+                Url                  = "http://www.externaldomain.com"
+                Internal             = $false
+                Ensure               = "Absent"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+

Modules/SharePointDsc/en-US/about_SPAntivirusSettings.help.txt

@@ -0,0 +1,67 @@
+.NAME
+    SPAntivirusSettings
+
+# Description
+
+    **Type:** Distributed
+
+    This resource is used to set the global antivirus settings for the local farm.
+    These settings will be used to control the behavior of an external anti-virus
+    scanning tool that is able to integrate with SharePoint. Note that this will
+    not scan documents for viruses on it's own, an external tool still needs to be
+    installed on the servers that integrates with SharePoint.
+
+.PARAMETER ScanOnDownload
+    Key - Boolean
+    Should documents be scanned before being downloaded
+
+.PARAMETER ScanOnUpload
+    Write - Boolean
+    Should documents be scanned on upload
+
+.PARAMETER AllowDownloadInfected
+    Write - Boolean
+    Should documents that are infected be allowed to be downloaded
+
+.PARAMETER AttemptToClean
+    Write - Boolean
+    Should infected documents be handed to the AV engine to attempt cleaning
+
+.PARAMETER TimeoutDuration
+    Write - Uint16
+    What is the timeout for an AV scan in seconds
+
+.PARAMETER NumberOfThreads
+    Write - Uint16
+    How many concurrent threads should the AV engine be able to run on a server
+
+.PARAMETER InstallAccount
+    Write - String
+    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
+
+
+.EXAMPLE
+    This example shows how to apply specific anti-virus configuration to the farm
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAntivirusSettings AVSettings
+            {
+                ScanOnDownload        = $true
+                ScanOnUpload          = $true
+                AllowDownloadInfected = $false
+                AttemptToClean        = $false
+            }
+        }
+    }
+
+

Modules/SharePointDsc/en-US/about_SPAppCatalog.help.txt

@@ -0,0 +1,47 @@
+.NAME
+    SPAppCatalog
+
+# Description
+
+    **Type:** Distributed
+
+    This resource will ensure that a specific site collection is marked as the app
+    catalog for the web application that the site is in. The catalog site needs to
+    have been created using the correct template (APPCATALOG#0).
+
+    This resource should be run using the farm account, and not another specific
+    setup account. Running this with the setup account you have used in your
+    configuration may relate to access denied errors.
+
+.PARAMETER SiteUrl
+    Key - string
+    The URL of the site collection that will be the app catalog for the web app that it is in
+
+.PARAMETER InstallAccount
+    Write - String
+    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
+
+
+.EXAMPLE
+    This example shows how to configure the AppCatalog in the farm
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAppCatalog MainAppCatalog
+            {
+                SiteUrl              = "https://content.sharepoint.contoso.com/sites/AppCatalog"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+

Modules/SharePointDsc/en-US/about_SPAppDomain.help.txt

@@ -0,0 +1,47 @@
+.NAME
+    SPAppDomain
+
+# Description
+
+    **Type:** Distributed
+
+    This resource will set the value for the app domain settings at the farm level.
+    You can set the domain name and the prefix that is to be used for app URLs.
+
+.PARAMETER AppDomain
+    Key - string
+    The domain name for apps to use in this farm
+
+.PARAMETER Prefix
+    Required - string
+    The prefix to go on to app URLs
+
+.PARAMETER InstallAccount
+    Write - String
+    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
+
+
+.EXAMPLE
+    This example shows how to apply app URLs to the current farm. 
+
+
+    Configuration Example 
+    {
+        param(
+            [Parameter(Mandatory = $true)]
+            [PSCredential]
+            $SetupAccount
+        )
+        Import-DscResource -ModuleName SharePointDsc
+
+        node localhost {
+            SPAppDomain LocalFarmAppUrls
+            {
+                AppDomain            = "contosointranetapps.com"
+                Prefix               = "app"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+