> For the complete documentation index, see [llms.txt](https://manuals.blusapphire.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.blusapphire.io/blugenie/full-function-list/connect-blugenietosystem.md).

# Connect-BluGenieToSystem



### Connect-BluGenieToSystem <a href="#connect-blugenietosystem" id="connect-blugenietosystem"></a>

### SYNOPSIS <a href="#synopsis" id="synopsis"></a>

Connect-BluGenieToSystem will spawn a remote session into the computer you specify

### SYNTAX <a href="#syntax" id="syntax"></a>

```
Connect-BluGenieToSystem [[-ComputerName] <String[]>] [-Walkthrough] [-Force] [-CopyModules] [-SystemtModulePath] [<CommonParameters>]
```

### DESCRIPTION <a href="#description" id="description"></a>

Connect-BluGenieToSystem is a trouble shooting process to spawn a remote session into the computer(s) you specify. You can also send the BluGenie Module, Service, and Tools to any of the rolling remote system directories&#x20;

&#x20;       \- $env:ProgramFiles\BluGenie (This is the Default Path)&#x20;

&#x20;       \- $env:ProgramFiles\WindowsPowerShell\ModuleSource

Note: When you copy the tools BluGenie will not Auto Load. It was designed to force an Import

### EXAMPLES <a href="#examples" id="examples"></a>

#### EXAMPLE 1 <a href="#example-1" id="example-1"></a>

```
Connect-BluGenieToSystem -ComputerName 10.20.136.52
```

```
This will try and resolve the IP to a Domain name, test to see if the system is online, and then spawn a remote session into the system
```

#### EXAMPLE 2 <a href="#example-2" id="example-2"></a>

```
Connect-BluGenieToSystem -ComputerName TestPC05
```

```
This will test to see if the system is online, and then spawn a remote session into the system
```

### PARAMETERS <a href="#parameters" id="parameters"></a>

#### ComputerName <a href="#computername" id="computername"></a>

```
-ComputerName <String[]>
   Description: Computer name or IP Address of the remote system.
   Notes: This can be an Array of systems.  All Systems will process in an asynchronous order and all connections will be minimized at start.
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    1
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Walkthrough <a href="#walkthrough" id="walkthrough"></a>

```
-Walkthrough [<SwitchParameter>]
   Description: An automated process to walk through the current function and all the parameters
   Notes:
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Force <a href="#force" id="force"></a>

```
-Force [<SwitchParameter>]
   Description: Do not test the connect to the computer, just execute the connection process
   Notes:
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### CopyModules <a href="#copymodules" id="copymodules"></a>

```
-CopyModules [<SwitchParameter>]
   Description: Copy the BluGenie Module content to the remote host over WinRM.  This will not use SMB.
   Notes: Default path is $env:\ProgramFiles\BluGenie
   
           If the default path is set you can run Import-Module 'C:\Program Files\BluGenie' to load the module
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### SystemtModulePath <a href="#systemtmodulepath" id="systemtmodulepath"></a>

```
-SystemtModulePath [<SwitchParameter>]
   Description: When Copying the BluGenie Module content set the save path to the default Windows PowerShell Module directory
   Notes: Path is $env:\ProgramFiles\WindowsPowerShell\Modules\BluGenie.
   
           If this path is set you can run Import-Module BluGenie without having to set a Module path
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### CommonParameters <a href="#commonparameters" id="commonparameters"></a>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).