Giter VIP home page Giter VIP logo

powershellget's Introduction

Join the chat at https://gitter.im/PowerShell/PowerShellGet License Documentation - PowerShellGet PowerShell Gallery - PowerShellGet Minimum Supported PowerShell Version

Introduction

PowerShellGet is a PowerShell module with commands for discovering, installing, updating and publishing the PowerShell artifacts like Modules, DSC Resources, Role Capabilities and Scripts.

PowerShellGet module is also integrated with the PackageManagement module as a provider, users can also use the PackageManagement cmdlets for discovering, installing and updating the PowerShell artifacts like Modules and Scripts.

Build status

Development branch

OS - PS Version Build Status
AppVeyor (Windows - PS 4.0) d-av-image
AppVeyor (Windows - PS 5.1) d-av-image
AppVeyor (Windows - PS 6.0.0-Alpha) d-av-image
Travis CI (Linux - PS 6.0.0-Alpha) d-tv-image
Travis CI (MacOS - PS 6.0.0-Alpha) d-tv-image

Master branch

OS - PS Version Build Status
AppVeyor (Windows - PS 4.0) m-av-image
AppVeyor (Windows - PS 5.1) m-av-image
AppVeyor (Windows - PS 6.0.0-Alpha) m-av-image
Travis CI (Linux - PS 6.0.0-Alpha) m-tv-image
Travis CI (MacOS - PS 6.0.0-Alpha) m-tv-image

Daily Build status

Development branch

OS - PS Version Build Status
AppVeyor (Windows - PS 4.0) d-n-av-image
AppVeyor (Windows - PS 5.1) d-n-av-image
AppVeyor (Windows - PS 6.0.0-Alpha) d-n-av-image
Travis CI (Linux - PS 6.0.0-Alpha) d-tv-image
Travis CI (MacOS - PS 6.0.0-Alpha) d-tv-image

Documentation

Click here

Requirements

  • Windows PowerShell 3.0 or newer.
  • PowerShell Core.

Module Dependencies

  • PackageManagement module

Get PowerShellGet Module

PowerShellGet is an in-box module in following releases

Get PowerShellGet module for PowerShell versions 3.0 and 4.0

Get the latest version from PowerShell Gallery

  • Before updating PowerShellGet, you should always install the latest Nuget provider. To do that, run the following in an elevated PowerShell session.
Install-PackageProvider Nuget –Force
Exit

For systems with PowerShell 5.0 (or newer) you can install both PowerShellGet

  • To do this on Windows 10, Windows Server 2016, or any system with WMF 5.0 or 5.1 installed, run the following commands from an elevated PowerShell session.
Install-Module –Name PowerShellGet –Force
Exit
  • Use Update-Module to get the next updated versions.
Update-Module -Name PowerShellGet
Exit

For systems running PowerShell 3 or PowerShell 4, that have installed the PackageManagement MSI

  • Use below PowerShellGet cmdlet to save the modules to a local directory
Save-Module PowerShellGet -Path C:\LocalFolder
Exit
  • Re-open the PS Console then run the following commands
Copy-Item "C:\LocalFolder\PowerShellGet\*" "$env:ProgramFiles\WindowsPowerShell\Modules\PowerShellGet\" -Recurse -Force
Copy-Item "C:\LocalFolder\PackageManagement\*" "$env:ProgramFiles\WindowsPowerShell\Modules\PackageManagement\" -Recurse -Force

Source

Steps

cd path/to/PowerShellGet
  • Import the module
Import-Module /path/to/PowerShellGet/PowerShellGet

Running Tests

Pester-based PowerShellGet Tests are located in <branch>/PowerShellGet/Tests folder.

Run following commands in PowerShell Console with Administrator privileges.

Import-Module "$ClonePath\tools\build.psm1"

Install-Dependencies

Invoke-PowerShellGetTest

Contributing to PowerShellGet

You are welcome to contribute to this project. There are many ways to contribute:

  • Submit a bug report via Issues. For a guide to submitting good bug reports, please read Painless Bug Tracking.
  • Read the documentation on contributing to open source and forking.
  • Verify fixes for bugs.
  • Submit your fixes for a bug. Before submitting, please make sure you have:
    • Performed code reviews of your own
    • Updated the test cases if needed
    • Run the test cases to ensure no feature breaks or test breaks
    • Added the test cases for new code
  • Submit a feature request.
  • Help answer questions in the discussions list.
  • Submit test cases.
  • Tell others about the project.
  • Tell the developers how much you appreciate the product!

You might also read these two blog posts about contributing code: Open Source Contribution Etiquette by Miguel de Icaza, and Don’t “Push” Your Pull Requests by Ilya Grigorik.

Before submitting a feature or substantial code contribution, please discuss it with the Windows PowerShell team via Issues, and ensure it follows the product roadmap. Note that all code submissions will be rigorously reviewed by the Windows PowerShell Team. Only those that meet a high bar for both quality and roadmap fit will be merged into the source.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.