# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuals.blusapphire.io/blugenie/full-function-list/connect-blugenietosystem.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.