# Install-BluGenieHarvester

﻿Install-BluGenieHarvester

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

Install-BluGenieHarvester will copy and install the Windows Event Harvester (WinLogBeat)

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

```
Install-BluGenieHarvester [[-Source] <String>] [[-Destination] <String>] [[-ForceCopy]] [[-Walkthrough]] [[-ReturnObject]] [[-OutUnEscapedJSON]] [[-ComputerName] <String>] [[-Install]] [[-Uninstall]] 
[[-Path] <String>] [[-ForceInstall]] [[-CopyOnly]] [<CommonParameters>]
```

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

Install-BluGenieHarvester will copy and install the Windows Event Harvester (WinLogBeat)

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

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

```
Install-BluGenieHarvester
```

```
This will copy the Harvester Source to the remote systems destination and install the the Harvester service.
```

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

```
Install-BluGenieHarvester -ForceCopy -ForceInstall
```

```
This will copy the Harvester Source to the remote systems destination and install the the Harvester service.
If the files and service already exist the ForceCopy will overwrite the current files and the ForceInstall will
remove and install the Harvester service.
```

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

```
Install-BluGenieHarvester -Source C:\NewSource -Destination 'C:\Program Files\NewDest'
```

```
This will copy the Harvester Source to the remote systems destination and install the the Harvester service.
The Source and Destination can be changed.  The default values are below.

Source:       $ToolsDirectory\Blubin\WinlogBeat
Destination:  C:\Program Files\WinlogBeat623
```

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

```
Install-BluGenieHarvester -Uninstall
```

```
This will remove all the source files for the Harvester and uninstall the service.
```

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

```
Install-BluGenieHarvester -ReturnObject
```

```
This will copy the Harvester Source to the remote systems destination and install the the Harvester service
and return just the Object content

Note:  The default output is a HashTable
```

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

```
Install-BluGenieHarvester -OutUnEscapedJSON
```

```
This will copy the Harvester Source to the remote systems destination and install the the Harvester service
and the return data will be in a beautified json format
```

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

#### Source <a href="#source" id="source"></a>

```
-Source <String>
   The Source path to the items to want to send
   
   The default is set to $ToolsDirectory\Blubin\WinlogBeat
   
   <Type>String<Type>
   
   Required?                    false
   Position?                    1
   Default value                $('{0}\Blubin\WinlogBeat\*.*' -f $ToolsDirectory)
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Destination <a href="#destination" id="destination"></a>

```
-Destination <String>
   The Destination path
   
   The default is set to 'C:\Program Files\WinlogBeat623'
   
   <Type>String<Type>
   
   Required?                    false
   Position?                    2
   Default value                $('{0}\WinlogBeat623' -f $env:ProgramFiles)
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### ForceCopy <a href="#forcecopy" id="forcecopy"></a>

```
-ForceCopy [<SwitchParameter>]
   Forces the file or directory creation or overwrite
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    3
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

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

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

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

```
-ReturnObject [<SwitchParameter>]
   Return information as an Object.
   By default the data is returned as a Hash Table
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    5
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

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

```
-OutUnEscapedJSON [<SwitchParameter>]
   Removed UnEsacped Char from the JSON Return.
   This will beautify json and clean up the formatting.
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    6
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

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

```
-ComputerName <String>
   Remote computer name
   
   <Type>String<Type>
   
   Required?                    false
   Position?                    7
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Install <a href="#install" id="install"></a>

```
-Install [<SwitchParameter>]
   Install the Harvester (This is the default option, without being called)
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    8
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Uninstall <a href="#uninstall" id="uninstall"></a>

```
-Uninstall [<SwitchParameter>]
   Uninstall the Harvester
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    9
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### Path <a href="#path" id="path"></a>

```
-Path <String>
   The Install path and file name for the Harvester
   
   The default is set to 'C:\Program Files\WinlogBeat623\winlogbeat.exe'
   
   <Type>String<Type>
   
   Required?                    false
   Position?                    10
   Default value                $('{0}\WinlogBeat623\winlogbeat.exe' -f $env:ProgramFiles)
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### ForceInstall <a href="#forceinstall" id="forceinstall"></a>

```
-ForceInstall [<SwitchParameter>]
   Overwrite the current installation and remove and reinstall the service.
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    11
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
```

#### CopyOnly <a href="#copyonly" id="copyonly"></a>

```
-CopyOnly [<SwitchParameter>]
   Copies the files to the remote system but, does not process an installation
   
   <Type>SwitchParameter<Type>
   
   Required?                    false
   Position?                    12
   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/install-blugenieharvester.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.
