Aan de slag met de PowerShell-galerieGet Started with the PowerShell Gallery

De PowerShell-galerie is de centrale opslagplaats voor PowerShell-inhoud.The PowerShell Gallery is the central repository for PowerShell content. In dit vindt u nuttige PowerShell-modules met PowerShell-opdrachten en resources Desired State Configuration (DSC).In it, you can find useful PowerShell modules containing PowerShell commands and Desired State Configuration (DSC) resources. U kunt ook PowerShell-scripts, kunnen sommige van deze PowerShell-werkstromen en overzicht maken van een set taken bevatten en sequentiëren voor deze taken bieden vinden.You can also find PowerShell scripts, some of which may contain PowerShell workflows, and which outline a set of tasks and provide sequencing for those tasks. Sommige van deze items zijn gemaakt door Microsoft en anderen zijn ontworpen door de PowerShell-community.Some of these items are authored by Microsoft, and others are authored by the PowerShell community.

VereistenRequirements

Downloaden van items uit de PowerShell-galerie in uw systeem vereist de PowerShellGet module.Downloading items from the PowerShell Gallery to your system requires the PowerShellGet module. U kunt de module PowerShellGet vinden in het volgende.You can find the PowerShellGet module in any of the following. U hoeft niet aan te melden bij het downloaden van items uit de PowerShell-galerie.You do not need to sign in to download items from the PowerShell Gallery.

PowerShellGet vereist ook de NuGet provider werken met de PowerShell-galerie.PowerShellGet also requires the NuGet provider to work with the PowerShell Gallery. U wordt gevraagd voor het installeren van de provider NuGet automatisch bij het eerste gebruik van PowerShellGet als de NuGet-provider niet in een van de volgende locaties is:You will be prompted to install the NuGet provider automatically upon first use of PowerShellGet if the NuGet provider is not in one of the following locations:

  • $env:ProgramFiles\PackageManagement\ProviderAssemblies
  • $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies

Of u kunt uitvoeren Install-PackageProvider -Name NuGet -Force voor het automatiseren van het downloaden en installeren van de NuGet-provider.Or, you can run Install-PackageProvider -Name NuGet -Force to automate the download and installation of the NuGet provider.

Als u een versie die ouder zijn dan 2.8.5.201 van NuGet hebt, moet u aan te roepen de volgende PowerShell-cmdlets voor het installeren en schakel over naar de nieuwste versie van het NuGet.If you have a version older than 2.8.5.201 of NuGet, you will need to call the following PowerShell cmdlets to install and switch to the latest version of NuGet.

  1. Install-PackageProvider NuGet -MinimumVersion '2.8.5.201' -Force
  2. Import-PackageProvider NuGet -MinimumVersion '2.8.5.201' -Force
  3. De oudere versie van NuGet verwijderen uit de bovenstaande locatie is geïnstalleerd.Delete the older version of NuGet from the above installed location.

Zie voor meer informatie http://oneget.org/ .For more information, see http://oneget.org/ .

Opmerking: Als gevolg van wijzigingen in de indelingen verpakking, wordt aangeraden dat u bijwerken naar de nieuwste versie van PowerShellGet en PackageManagement voor het installeren van de items die onlangs zijn bijgewerkt.Note: Due to changes in packaging formats, we recommend you update to the latest version of PowerShellGet and PackageManagement to install items that have been updated recently. PowerShellGet is opgenomen in Windows 10, kunt u meer informatie over hier.PowerShellGet is included in Windows 10, which you can learn more about here. PowerShellGet maakt ook deel uit van de Windows Management Framework (WMF) 5.0, die u kunt downloaden hier.PowerShellGet is also part of the Windows Management Framework (WMF) 5.0, which you can download here.

U kunt items in de PowerShell-galerie vinden met behulp van de Search besturingselement op deze website, of door te bladeren door de pagina's Modules en -Scripts.You can find items in the PowerShell Gallery by using the Search control on this website, or by browsing through the Modules and Scripts pages. U kunt items van de PowerShell Gallery ook vinden door het uitvoeren van de Find-Module en zoeken Script cmdlets, afhankelijk van het itemtype met -Repository PSGallery.You can also find items from the PowerShell Gallery by running the Find-Module and Find-Script cmdlets, depending on the item type, with -Repository PSGallery.

Filteren van resultaten uit de galerie kan worden gedaan met behulp van de volgende parameters van Find-Module en Find-ScriptFiltering results from the Gallery can be done by using the following parameters of Find-Module and Find-Script

  • NaamName
  • AllVersionsAllVersions
  • MinimumVersionMinimumVersion
  • RequiredVersionRequiredVersion
  • LabelTag
  • BevatIncludes
  • DscResourceDscResource
  • RoleCapabilityRoleCapability
  • OpdrachtCommand
  • FilterFilter

U kunt uitvoeren als u alleen geïnteresseerd bent in het detecteren van specifieke DSC-resources in de galerie, de zoeken DscResource cmdlet.If you're only interested in discovering specific DSC resources in the Gallery, you can run the Find-DscResource cmdlet. Zoeken naar DscResource retourneert gegevens van de DSC-resources die zijn opgenomen in de galerie.Find-DscResource returns data on DSC resources contained in the Gallery. Omdat de DSC-resources zijn altijd geleverd als onderdeel van een module, moet u nog steeds uitgevoerd Install-Module voor het installeren van de DSC-resources.Because DSC resources are always delivered as part of a module, you still need to run Install-Module to install those DSC resources.

Zodra u een item dat u geïnteresseerd bent in hebt geïdentificeerd, kunt u meer informatie over het.Once you've identified an item you're interested in, you may want to learn more about it. U kunt dit doen door te controleren dat item specifieke pagina in de galerie.You can do this by examining that item's specific page on the Gallery. Klik op deze pagina kunt u zult kunnen zien alle van de metagegevens geüpload met het item.On that page, you'll be able to see all of the metadata uploaded with the item. Deze metagegevens voor een item wordt aangeboden door de auteur van het item en is niet geverifieerd door Microsoft.This metadata for an item is provided by the item's author, and is not verified by Microsoft. De eigenaar van het item ten zeerste aan het galerie-account gebruikt voor het publiceren van het item is gekoppeld en is betrouwbaarder dan het veld Auteur.The Owner of the item is strongly tied to the Gallery account used to publish the item, and is more trustworthy than the Author field.

Als u ontdekt dat een item dat u van mening bent dat niet is gepubliceerd te goeder trouw, klikt u op misbruik melden op de pagina van het artikel.If you discover an item that you feel is not published in good faith, click Report Abuse on that item's page.

Als u werkt met Find-Module of zoeken Script, u kunt deze gegevens weergeven in de geretourneerde PSGetModuleInfo-object.If you're running Find-Module or Find-Script, you can view this data in the returned PSGetModuleInfo object. Bijvoorbeeld, Find-Module -Name PSReadLine -Repository PSGallery | Get-Member retourneert gegevens voor de module PSReadLine in de galerie.For example, running Find-Module -Name PSReadLine -Repository PSGallery | Get-Member returns data on the PSReadLine module in the Gallery.

Bij het downloaden van items van de PowerShell Gallery raden we het volgende proces:We encourage the following process when downloading items from the PowerShell Gallery:

ControlerenInspect

Voor het downloaden van een item uit de galerie voor inspectie, voer de opslaan-Module of opslaan Script cmdlet, afhankelijk van het itemtype.To download an item from the Gallery for inspection, run either the Save-Module or Save-Script cmdlet, depending on the item type. Hiermee kunt u het item lokaal opslaan zonder het te installeren en de inhoud van het item controleren.This lets you save the item locally without installing it, and inspect the item contents. Onthoud het opgeslagen item handmatig verwijderen.Remember to delete the saved item manually.

Sommige van deze items zijn gemaakt door Microsoft en anderen zijn ontworpen door de PowerShell-community.Some of these items are authored by Microsoft, and others are authored by the PowerShell community. Microsoft raadt aan dat u de inhoud en code van de items in deze galerie voorafgaand aan installatie bekijken.Microsoft recommends that you review the contents and code of items on this gallery prior to installation.

Als u ontdekt dat een item dat u van mening bent dat niet is gepubliceerd te goeder trouw, klikt u op misbruik melden op de pagina van het artikel.If you discover an item that you feel is not published in good faith, click Report Abuse on that item's page.

InstallerenInstall

Uitvoeren als u wilt installeren een item uit de galerie voor gebruik, de Install-Module of Script voor installatie cmdlet, afhankelijk van het itemtype.To install an item from the Gallery for use, run either the Install-Module or Install-Script cmdlet, depending on the item type.

Installatie-Module installeert u de module $env:ProgramFiles\WindowsPowerShell\Modules standaard.Install-Module installs the module to $env:ProgramFiles\WindowsPowerShell\Modules by default. Hiervoor moet een administrator-account.This requires an administrator account. Als u de -Scope CurrentUser parameter, de module is geïnstalleerd op $env:USERPROFILE\Documents\WindowsPowerShell\Modules .If you add the -Scope CurrentUser parameter, the module is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Modules .

Script voor installatie installeert u het script $env:ProgramFiles\WindowsPowerShell\Scripts standaard.Install-Script installs the script to $env:ProgramFiles\WindowsPowerShell\Scripts by default. Hiervoor moet een administrator-account.This requires an administrator account. Als u de -Scope CurrentUser parameter, het script wordt geïnstalleerd op $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .If you add the -Scope CurrentUser parameter, the script is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .

Standaard Install-Module en Script voor installatie installeert de meest recente versie van een item.By default, Install-Module and Install-Script installs the most current version of an item. Voor het installeren van een oudere versie van het item toevoegen de -RequiredVersion parameter.To install an older version of the item, add the -RequiredVersion parameter.

ImplementeerDeploy

Voor het implementeren van een item uit de galerie PowerShell voor Azure Automation, klikt u op implementeren in Azure Automation op de detailpagina item.To deploy an item from the PowerShell Gallery to Azure Automation, click Deploy to Azure Automation on the item details page. U wordt omgeleid naar de Azure-beheerportal, waar u zich aanmelden met behulp van de referenties van uw Azure-account.You will be redirected to the Azure Management Portal, where you sign in by using your Azure account credentials. Houd er rekening mee dat het implementeren van items met afhankelijkheden alle afhankelijkheden voor Azure Automation inzetten.Note that deploying items with dependencies will deploy all the dependencies to Azure Automation. De knop 'Implementeren in Azure Automation' kan worden uitgeschakeld door het toevoegen van de AzureAutomationNotSupported label in de itemmetagegevens van uw.The 'Deploy to Azure Automation' button can be disabled by adding the AzureAutomationNotSupported tag to your item metadata.

Zie voor meer informatie over Azure Automation, de Azure Automation-website.To learn more about Azure Automation, see the Azure Automation website.

Voor het bijwerken van items die zijn geïnstalleerd vanuit de PowerShell-galerie, voer de Update-Module of -updatescript cmdlet.To update items installed from the PowerShell Gallery, run either the Update-Module or Update-Script cmdlet. Wanneer uitgevoerd zonder extra parameters, Update-Module probeert bij te werken van elke module die is geïnstalleerd door het uitvoeren van Install-Module.When run without any additional parameters, Update-Module attempts to update each module installed by running Install-Module. Om bij te werken selectief modules, voeg de -Name parameter.To selectively update modules, add the -Name parameter.

Op dezelfde manier als uitvoert zonder extra parameters, -updatescript ook probeert om te werken van elk geïnstalleerd door het uitvoeren van script Script voor installatie.Similarly, when run without any additional parameters, Update-Script also attempts to update each script installed by running Install-Script. Voor het selectief bijwerken scripts, voeg de -Name parameter.To selectively update scripts, add the -Name parameter.

Als u wilt weten welke modules die u hebt geïnstalleerd vanuit de PowerShell-galerie, voer de Get-InstalledModule cmdlet.To find out which modules you have installed from the PowerShell Gallery, run the Get-InstalledModule cmdlet. Met deze opdracht worden alle van de modules die op uw systeem is geïnstalleerd en die rechtstreeks vanuit de PowerShell-galerie zijn geïnstalleerd.This command lists all of the modules you have on your system that were installed directly from the PowerShell Gallery.

Op dezelfde manier als u wilt weten welke scripts die u hebt geïnstalleerd vanuit de PowerShell-galerie, voer de Get-InstalledScript cmdlet.Similarly, to find out which scripts you have installed from the PowerShell Gallery, run the Get-InstalledScript cmdlet. Met deze opdracht worden alle van de scripts die op uw systeem is geïnstalleerd en die rechtstreeks van de PowerShell Gallery zijn geïnstalleerd.This command lists all of the scripts you have on your system that were installed directly from the PowerShell Gallery.