Giter Club home page Giter Club logo

pnp-powershell-extension's Introduction

PnP PowerShell extension

version installs

This extension will boost your productivity when creating scripts that use PnP PowerShell. Currently, the extension provides:

  • embedded documentation
  • samples powered by PnP Script Sample Gallery
  • snippets with all possible PnP PowerShell commands

Please check PnP PowerShell docs for more information.

samples

✨ Capabilities

1️⃣ Script samples gallery

Using PnP PS: Open samples gallery command, or the 'Samples' button from the controls above the command list, you may open the gallery with all available script samples. Currently, the samples shown are retrieved from the PnP script samples repository. From the samples gallery you may go to the sample location or create a new tab (file) in the editor prefilled with the PnP PowerShell script. It is possible to search for samples by:

  • title
  • authors
  • commands used in samples

samples

2️⃣ Docs

This functionality provides PnP PowerShell docs view for all commands inside VS Code. No more context switching between the code editor and browser. It is possible to go to docs original website location and also open the sample gallery showing all samples using that command.

docs

It is also possible to use the command PnP PS: Open docs for command to open the docs for a specific command.

docs

3️⃣ Command list tree view

docs

The command list also has the functionality to group commands view by command name verb

docs

4️⃣ Snippets

The extensions help to quickly find the correct PnP PowerShell command and use it thanks to code snippets. The command is added along with all required parameters. It is possible to quickly move between parameters using 'Tab' key. Each snippet has a description which may be found in the docs which is a great help to quickly understand the commands functionality.

snippetsList

In order to use snippets please type part of a PnP PowerShell command and press enter or tab. The command will be automatically added to the code along with all required parameters. You may also use 'Ctrl + Space' (Windows, Linux) or 'Cmd + Space' (macOS) to activate snippets from within the editor.

snippetsList

It is also possible to use the command Insert Snippet in VS Code to see the full list

snippetsList

5️⃣ Transition to PnP PowerShell Docs website

The extension provides many ways to go to the PnP PowerShell Docs web page or GitHub repository.

docs

🤖 Commands

The extension provides the following commands:

command description
PnP PS: Open samples gallery Opens up the sample gallery
PnP PS: Open docs for command Search for a command doc file. The command may also be prefilled by the selected PnP PowerShell command

commands

🙋 Support

This project is a community lead extension provided by the Microsoft 365 and Power Platform Community members. Questions, problems, or feedback is more than welcome. Please create an issue in the extension repository issue list.

👍 Community

Are you building experiences for Microsoft 365? - Everyone is welcome to join our Microsoft 365 and Power Platform Community efforts with community calls, samples and guidance. Join our weekly community calls for Microsoft 365 and Power Platform topics or engage with us on Discord. Everyone is welcome 🧡

🧾 Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

😍 "Sharing is Caring"

Microsoft 365 & Power Platform Community

🔑 License

MIT License

⚠️ Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.

pnp-powershell-extension's People

Contributors

adam-it avatar dependabot[bot] avatar github-actions[bot] avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar

pnp-powershell-extension's Issues

🆕 [Feature]: align Icon size

🎯 Aim of the feature

Aim would be to work on the icons to align their size with CLI vs code extension

📷 Images (if possible) with expected result

image
image

BTW I should add icon for the repo as well

Improve readme

🎯 Aim

The aim is to improve product readme and tags

Add recognition to sample cards

Hi @Adam-it

This is awesome work on the extensions. If I may offer a suggestion, can you add some mention in the samples or the preview who the author was? Its quite important that we recognize those that have spent time creating these samples.

image

🆕 [Feature]: UI for commands

🎯 Aim of the feature

Would be to create a tab in the docs view to present and input for each command option. User should be able to give value for each option (the form should validate for required options) and this should dynamically create a command line to be copied and used in file

Idea: Show samples within commandlet doc

Hi Adam,

In the cmdlet view, is it possible to filter and show related samples? I do tag samples within the tags element of the samples.json - CLI cmds as well.

image

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.