> 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/start-blugenienewprocess.md).

# Start-BluGenieNewProcess

﻿

### Start-BluGenieNewProcess <a href="#start-blugenienewprocess" id="start-blugenienewprocess"></a>

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

Start-BluGenieNewProcess is similar to Start-Process but can capture all Standard Output

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

```
Start-BluGenieNewProcess [[-FileName] <String>] [[-Arguments] <String>] [[-WorkingDirectory] <String>] [-Walkthrough] [-ReturnObject] [-OutUnEscapedJSON] [<CommonParameters>]
```

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

Start-BluGenieNewProcess is similar to Start-Process but can capture all Standard Output while keeping the screen hidden

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

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

```
Command: Start-BluGenieNewProcess ping.exe 'localhost'
```

```
Description: Start a process and capture the Standard Output using the default parameter position
Notes: 
- Sample Output -
FileName         : ping.exe                                                 
Arguments        : localhost                                                
WorkingDirectory :                                                          
StdOut           :                                                          
                 Pinging Computer1 [::1] with 32 bytes of data:
                 Reply from ::1: time<1ms                                 
                 Reply from ::1: time<1ms                                 
                 Reply from ::1: time<1ms                                 
                 Reply from ::1: time<1ms                                 
                                                                          
                 Ping statistics for ::1:                                 
                     Packets: Sent = 4, Received = 4, Lost = 0 (0% loss), 
                 Approximate round trip times in milli-seconds:           
                     Minimum = 0ms, Maximum = 0ms, Average = 0ms
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost' | Select-Object -ExpandProperty StdOut
```

```
Description: Start a process and only capture the Standard Output
Notes:
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost'
```

```
Description: Start a process and capture the Standard Output using the parameter names
Notes:
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost' -WorkingDirectory 'C:\Windows\System32'
```

```
Description: Start a process from a specfic Working Directory
Notes:
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost' -ReturnObject:$false
```

```
Description: Start a process and capture the Standard Output and Return Output as a Hash Table
Notes:
```

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

```
Command: Start-BluGenieNewProcess -Help
```

```
Description: Call Help Information
Notes: If Help / WalkThrough is setup as a parameter, this script will be called to setup the Dynamic Help Menu if not the normal Get-Help will be called with the -Full parameter
```

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

```
Command: Start-BluGenieNewProcess -WalkThrough
```

```
Description: Call Help Information [2]
Notes: If Help / WalkThrough is setup as a parameter, this script will be called to setup the Dynamic Help Menu if not the normal Get-Help will be called with the -Full parameter
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost' -OutUnEscapedJSON
```

```
Description: Start a process and capture the Standard Output and Return Output as UnEscaped JSON format
Notes:  The OutUnEscapedJSON is used to beatify the JSON return and not Escape any Characters.  Normal return data is a Hash Table.
```

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

```
Command: Start-BluGenieNewProcess -FileName 'ping.exe' -Arguments 'localhost' -ReturnObject
```

```
Description: Start a process and capture the Standard Output and Return Output an Object
Notes:  The ReturnObject is used to return a PowerShell Object.  This is the default
```

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

#### FileName <a href="#filename" id="filename"></a>

```
-FileName <String>
   Description: The Path and Filename of the process
   Notes:  
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    1
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Arguments <a href="#arguments" id="arguments"></a>

```
-Arguments <String>
   Description: Process arguments
   Notes:  
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    2
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### WorkingDirectory <a href="#workingdirectory" id="workingdirectory"></a>

```
-WorkingDirectory <String>
   Description: Working direcotry for the started process
   Notes:  
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    3
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

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

```
-Walkthrough [<SwitchParameter>]
   Description:  Start the dynamic help menu system to help walk through the current command and all of the parameters
   Notes:  
   Alias: Help
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### ReturnObject <a href="#returnobject" id="returnobject"></a>

```
-ReturnObject [<SwitchParameter>]
   Description: Return information as an Object
   Notes: By default the data is returned as a Hash Table
   Alias: 
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                True
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### OutUnEscapedJSON <a href="#outunescapedjson" id="outunescapedjson"></a>

```
-OutUnEscapedJSON [<SwitchParameter>]
   Description: Remove UnEsacped Char from the JSON information.
   Notes: This will beautify json and clean up the formatting.
   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).
