Install-DbaParquet

Synopsis

Installs Parquet.NET assemblies required by Import-DbaParquet.

Description

Downloads Parquet.NET from NuGet and installs the netstandard2.0 assemblies into the dbatools data directory.
The installer also downloads and extracts the managed dependency closure declared by the NuGet packages.

Parquet.NET is a managed .NET library, so the installed assemblies work across Windows, Linux, and macOS as long
as the host PowerShell/.NET runtime can load netstandard2.0 assemblies.

By default, assemblies are installed to the dbatools data directory for the current user. Use -Path for a custom
portable location, or -LocalFile to install from an already downloaded nupkg, zip, or folder that contains
Parquet.dll or Parquet.Net.dll and its dependencies.

Syntax

Install-DbaParquet
    [[-Path] <String>]
    [[-Version] <String>]
    [[-LocalFile] <String>]
    [-Force]
    [-EnableException]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Examples

Example 1: Downloads Parquet.NET and dependencies from NuGet and installs them to the dbatools data directory

PS C:\> Install-DbaParquet

Example 2: Installs Parquet.NET and dependencies to C:\dbatools\parquet

PS C:\> Install-DbaParquet -Path C:\dbatools\parquet

Example 3: Installs Parquet.NET from a local zip file containing Parquet.dll and its dependencies

PS C:\> Install-DbaParquet -LocalFile C:\temp\parquet-libs.zip

Optional Parameters

-Path

Specifies the directory where Parquet.NET assemblies will be installed.
If not specified, defaults to the Path.DbatoolsParquet configuration value.

-Version

Specifies the Parquet.Net NuGet package version to install. Defaults to 5.4.0, the version used by Import-DbaParquet.
Parquet.Net 5.5.0 and later ship a netstandard2.0 build whose read path throws NotImplementedException
(StreamExtensions.CopyToAsync), which breaks Windows PowerShell, so do not bump this default until upstream fixes it.

-LocalFile

Specifies a local nupkg, zip file, or directory containing Parquet.dll or Parquet.Net.dll and its dependency DLLs.
Use this for offline or pre-approved package installs. Local nupkg files only contain Parquet.NET itself, so
dependency DLLs must also be present if installing without internet access.

-Force

Forces re-download and reinstallation even if Parquet.NET already exists in the target location.

-EnableException

By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with “sea of red” exceptions, but is inconvenient because it basically disables advanced scripting.
Using this switch turns this “nice by default” feature off and enables you to catch exceptions with your own try/catch.

-WhatIf

Shows what would happen if the command were to run. No actions are actually performed.

-Confirm

Prompts you for confirmation before executing any operations that change state.

Outputs

PSCustomObject

Returns installation details when Parquet.NET is installed or already present.

Properties:

• Name: The primary assembly name
• Path: The full file path to the Parquet.NET assembly
• Version: The installed Parquet.NET file version
• Installed: Boolean value of $true indicating successful installation