Run SIF remotely

Version: 10.5

PowerShell Remoting lets you run SIF configurations on a remote computer.

Enable PowerShell remoting

To enable PowerShell remoting:

  • On the remote computer, in a PowerShell command line, run the Enable-PSRemoting cmdlet.
Note

You must enable PowerShell remoting for the user that completes the installation, and this user must have administrator rights to perform the deployment. For more information about securing or configuring a computer for remote access, see Microsoft's documentation.

SIF uses SSL to create a remote PowerShell session. You must configure Windows Remote Management (WinRM) to work over HTTPS. For more information, see Microsoft Support.

Start a remote installation

To start a remote deployment:

  1. Install SIF on the remote computer.

  2. In a PowerShell command line, create a new remote session:

    $session = New-PSSession -ComputerName <RemoteComputerName>
  3. To copy all the required packages and SIF configuration files to the remote computer, specify the path and then run the following cmdlet:

    Copy-Item -Path <sourcefile> -Destination -<remotePath> -ToSession $session
  4. To start the installation, run the following cmdlet:

    
    $session = New-PSSession -ComputerName  <RemoteComputerName>
    
    Invoke-Command -Session $session { Import-Module SitecoreInstallFramework }
    
    Invoke-Command -Session $session { Install-SitecoreConfiguration -Path <configurationpath> }
    
Note

For more information about the Invoke-Command cmdlet, see the PowerShell documentation.

If you have suggestions for improving this article, let us know!