en-US/about_SPInstall.help.txt
|
.NAME
SPInstall # Description This resource is used to install the SharePoint binaries. The BinaryDir parameter should point to the path that setup.exe is located (not to setup.exe itself). The ProductKey parameter is used to inject in to the configuration file and validate the license key during the installation process. This module depends on the prerequisites already being installed, which can be done NOTE: This resource only supports SharePoint Server. SharePoint Foundation is not supported. For examples to install SharePoint Foundation using DSC, see: https://github.com/PowerShell/SharePointDsc/wiki/SPInstall (Example 3) ## Installing from network locations If you wish to install SharePoint from a network location this can be done, however you must disable User Account Control (UAC) on the server to allow DSC to run the executable from a remote location, and also set the PsDscRunAsCredential value to run as an account with local admin permissions as well as read access to the network location. It is *not recommended* to disable UAC for security reasons. The recommended approach is to copy the installation media to the local nodes first and then execute the installation from there. .PARAMETER BinaryDir Key - String The directory that contains all of the SharePoint binaries .PARAMETER ProductKey Required - String The product key to use during the installation .PARAMETER InstallPath Write - String The install directory to use in the installation, leave blank to use the setup defaults .PARAMETER DataPath Write - String The data directory to use in the installation, leave blank to use the setup defaults .PARAMETER Ensure Write - string Allowed values: Present, Absent Present to install SharePoint. Absent is currently not supported .EXAMPLE This module will install SharePoint to the default locations. The binaries for SharePoint in this scenario are stored at C:\SPInstall (so it will look to run C:\SPInstall\Setup.exe) Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPInstall InstallBinaries { BinaryDir = "C:\SPInstall" ProductKey = "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" } } } .EXAMPLE This module will install SharePoint to the specific locations set for the InstallPath and DataPath directories. Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPInstall InstallBinaries { BinaryDir = "D:\SharePoint\Binaries" InstallPath = "D:\SharePoint\Install" DataPath = "D:\SharePoint\Data" ProductKey = "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" } } } .EXAMPLE This module will install SharePoint Foundation 2013 to the local server Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName PSDesiredStateConfiguration node localhost { Package InstallSharePointFoundation { Ensure = "Present" Name = "Microsoft SharePoint Foundation 2013 Core" Path = "E:\SharePoint2013\Setup.exe" Arguments = "/config E:\SharePoint2013\files\setupfarmsilent\config.xml" ProductID = "90150000-1014-0000-1000-0000000FF1CE" ReturnCode = 0 } } } |