Merge branch 'master' of https://github.com/PowerShell/SharePointDsc into release-1.5

Author: Brian Farnhill

Modules/SharePointDsc/SharePointDsc.psd1

@@ -113,7 +113,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,86 @@
+.NAME
+    SPAccessServiceApp
+
+.DESCRIPTION
+    
+    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.
+    
+.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,83 @@
+.NAME
+    SPAlternateUrl
+
+.DESCRIPTION
+    
+    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. 
+    
+.PARAMETER WebAppUrl
+    Key - String
+    The URL 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
+    Write - String
+    The new alternate URL
+
+.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
+            {
+                WebAppUrl            = "http://sharepoint1:9999"
+                Zone                 = "Intranet"
+                Url                  = "https://admin.sharepoint.contoso.com"
+                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
+            {
+                WebAppUrl            = "http://sharepoint1:9999"
+                Zone                 = "Intranet"
+                Ensure               = "Absent"
+                PsDscRunAsCredential = $SetupAccount
+            }
+        }
+    }
+
+

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

@@ -0,0 +1,64 @@
+.NAME
+    SPAntivirusSettings
+
+.DESCRIPTION
+    
+    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,41 @@
+.NAME
+    SPAppCatalog
+
+.DESCRIPTION
+    
+    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).
+    
+.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,45 @@
+.NAME
+    SPAppDomain
+
+.DESCRIPTION
+    
+    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
+            }
+        }
+    }
+
+