en-US/about_SPInstallPrereqs.help.txt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
.NAME
    SPInstallPrereqs

# Description
    
    This resource is responsible for ensuring the installation of all SharePoint
    prerequisites. It makes use of the PrerequisiteInstaller.exe file that is part
    of the SharePoint binaries, and will install the required Windows features as
    well as additional software. The OnlineMode boolean will tell the prerequisite
    installer which mode to run in, if it is online you do not need to list any
    other parameters for this resource. If you do not use online mode, you must
    include all other parameters to specify where the installation files are
    located. These additional parameters map directly to the options passed to
    prerequisiteinstaller.exe. For installations with no connectivity to Windows
    Update, use the SXSpath parameter to specify the path to the SXS store of your
    Windows Server install media.
    
    Additionally, the process of installing the prerequisites on a Windows Server
    usually results in 2-3 restarts of the system being required. To ensure the
    DSC configuration is able to restart the server when needed, ensure the below
    settings for the local configuration manager are included in your DSC file.
    
        LocalConfigurationManager
        {
            RebootNodeIfNeeded = $true
        }
    
    ## Installing from network locations
    
    If you wish to install the prerequisites 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 InstallerPath
    Key - String
    The full path to prerequisiteinstaller.exe

.PARAMETER OnlineMode
    Required - Boolean
    Should the installer download prerequisites from the internet or not

.PARAMETER SXSpath
    Write - String
    The path to the Windows Server Operating System SXS source files, for use in closed environments without access to Windows Update

.PARAMETER SQLNCli
    Write - String
    The path to the installer for this prerequisite

.PARAMETER PowerShell
    Write - String
    The path to the installer for this prerequisite

.PARAMETER NETFX
    Write - String
    The path to the installer for this prerequisite

.PARAMETER IDFX
    Write - String
    The path to the installer for this prerequisite

.PARAMETER Sync
    Write - String
    The path to the installer for this prerequisite

.PARAMETER AppFabric
    Write - String
    The path to the installer for this prerequisite

.PARAMETER IDFX11
    Write - String
    The path to the installer for this prerequisite

.PARAMETER MSIPCClient
    Write - String
    The path to the installer for this prerequisite

.PARAMETER WCFDataServices
    Write - String
    The path to the installer for this prerequisite

.PARAMETER KB2671763
    Write - String
    The path to the installer for this prerequisite

.PARAMETER WCFDataServices56
    Write - String
    The path to the installer for this prerequisite

.PARAMETER MSVCRT11
    Write - String
    The path to the installer for this prerequisite

.PARAMETER MSVCRT14
    Write - String
    The path to the installer for this prerequisite

.PARAMETER KB3092423
    Write - String
    The path to the installer for this prerequisite

.PARAMETER ODBC
    Write - String
    The path to the installer for this prerequisite

.PARAMETER DotNetFx
    Write - String
    The path to the installer for this prerequisite

.PARAMETER Ensure
    Write - string
    Allowed values: Present, Absent
    Present to install the prerequisites. Absent is currently not supported


.EXAMPLE
    This module will install the prerequisites for SharePoint. This resource will run in
    online mode, looking to download all prerequisites from the internet.


    Configuration Example 
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc

        node localhost {
            SPInstallPrereqs InstallPrerequisites
            {
                InstallerPath     = "C:\SPInstall\Prerequisiteinstaller.exe"
                OnlineMode        = $true
            }
        }
    }


.EXAMPLE
    This module will install the prerequisites for SharePoint 2013. This resource will run in
    offline mode, running all prerequisite installations from the specified paths.


    Configuration Example 
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc

        node localhost {
            SPInstallPrereqs InstallPrerequisites
            {
                InstallerPath     = "C:\SPInstall\Prerequisiteinstaller.exe"
                OnlineMode        = $false
                SXSpath          = "c:\SPInstall\Windows2012r2-SXS"
                SQLNCli           = "C:\SPInstall\prerequisiteinstallerfiles\sqlncli.msi"
                PowerShell        = "C:\SPInstall\prerequisiteinstallerfiles\Windows6.1-KB2506143-x64.msu"
                NETFX             = "C:\SPInstall\prerequisiteinstallerfiles\dotNetFx45_Full_setup.exe"
                IDFX              = "C:\SPInstall\prerequisiteinstallerfiles\Windows6.1-KB974405-x64.msu"
                Sync              = "C:\SPInstall\prerequisiteinstallerfiles\Synchronization.msi"
                AppFabric         = "C:\SPInstall\prerequisiteinstallerfiles\WindowsServerAppFabricSetup_x64.exe"
                IDFX11            = "C:\SPInstall\prerequisiteinstallerfiles\MicrosoftIdentityExtensions-64.msi"
                MSIPCClient       = "C:\SPInstall\prerequisiteinstallerfiles\setup_msipc_x64.msi"
                WCFDataServices   = "C:\SPInstall\prerequisiteinstallerfiles\WcfDataServices.exe"
                KB2671763         = "C:\SPInstall\prerequisiteinstallerfiles\AppFabric1.1-RTM-KB2671763-x64-ENU.exe"
                WCFDataServices56 = "C:\SPInstall\prerequisiteinstallerfiles\WcfDataServices56.exe"
            }
        }
    }