Delen via

Aan de slag met de PowerShell Gallery

  • Artikel

PowerShell Gallery is een pakketopslagplaats met scripts, modules en DSC-resources die u kunt downloaden en gebruiken. U gebruikt de cmdlets in de module PowerShellGet om pakketten te installeren vanuit de PowerShell Gallery. U hoeft zich niet aan te melden om items te downloaden uit de PowerShell Gallery.

Notitie

Het is mogelijk om een pakket rechtstreeks vanuit de PowerShell Gallery te downloaden, maar dit is geen aanbevolen benadering. Zie Handmatig pakket downloadenvoor meer informatie.

U vindt pakketten in de PowerShell Gallery met behulp van het besturingselement Zoeken op de startpagina van de PowerShell-galerie, of door te bladeren door de modules en scripts vanaf de pagina Pakketten. U kunt ook pakketten vinden in de PowerShell Gallery door de Find-Module, Find-DscResourceen Find-Script cmdlets uit te voeren, afhankelijk van het pakkettype, met -Repository PSGallery.

U kunt resultaten uit de galerie filteren met behulp van de volgende parameters:

  • Naam
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Label
  • Bevat
  • DscResource
  • RoleCapability
  • Bevelen
  • Filter

Als u alleen specifieke DSC-resources wilt detecteren in de galerie, kunt u de Find-DscResource cmdlet uitvoeren. Find-DscResource retourneert gegevens over DSC-resources in de galerie. Omdat DSC-resources altijd worden geleverd als onderdeel van een module, moet u nog steeds Install-Module uitvoeren om deze DSC-resources te installeren.

Zodra u een pakket hebt geïdentificeerd waarin u geïnteresseerd bent, wilt u er mogelijk meer over weten. U kunt dit doen door de specifieke pagina van dat pakket in de galerie te bekijken. Op die pagina kunt u alle metagegevens zien die met het pakket zijn geüpload. Deze metagegevens worden geleverd door de auteur van het pakket en worden niet geverifieerd door Microsoft. De eigenaar van het pakket is sterk gekoppeld aan het galerieaccount dat wordt gebruikt om het pakket te publiceren en is betrouwbaarder dan het veld Auteur.

Als u een pakket ontdekt dat u niet in goed vertrouwen hebt gepubliceerd, klikt u op Rapport misbruik op de pagina van dat pakket.

Als u Find-Module of Find-Scriptuitvoert, kunt u deze gegevens bekijken in het geretourneerde PSGetModuleInfo-object. In het volgende voorbeeld worden gegevens geretourneerd in de module PSReadLine in de galerie.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

We raden het volgende proces aan bij het downloaden van pakketten uit de PowerShell Gallery:

Inspecteren

Als u een pakket wilt downloaden uit de galerie voor inspectie, voert u de Save-Module of Save-Script cmdlet uit, afhankelijk van het pakkettype. Hiermee kunt u het pakket lokaal opslaan zonder het te installeren en de inhoud van het pakket te inspecteren. Vergeet niet om het opgeslagen pakket handmatig te verwijderen.

Sommige van deze pakketten zijn geschreven door Microsoft en andere zijn geschreven door de PowerShell-community. Microsoft raadt u aan de inhoud en code van pakketten in deze galerie te controleren voordat u deze installeert.

Als u een pakket ontdekt dat u niet in goed vertrouwen hebt gepubliceerd, klikt u op Rapport misbruik op de pagina van dat pakket.

Installeren

Als u een pakket wilt installeren vanuit de galerie voor gebruik, voert u de Install-Module of Install-Script cmdlet uit, afhankelijk van het pakkettype.

Install-Module installeert de module standaard op $env:ProgramFiles\WindowsPowerShell\Modules. Hiervoor is een beheerdersaccount vereist. Als u de parameter -Scope CurrentUser toevoegt, wordt de module geïnstalleerd op $HOME\Documents\WindowsPowerShell\Modules.

Install-Script installeert het script standaard op $env:ProgramFiles\WindowsPowerShell\Scripts. Hiervoor is een beheerdersaccount vereist. Als u de parameter -Scope CurrentUser toevoegt, wordt het script geïnstalleerd op $HOME\Documents\WindowsPowerShell\Scripts.

Standaard installeert Install-Module en Install-Script de meest recente versie van een pakket. Als u een oudere versie van het pakket wilt installeren, voegt u de parameter -RequiredVersion toe.

Implementeren

Als u een pakket wilt implementeren vanuit de PowerShell Gallery in Azure Automation, klikt u op Azure Automation-en klikt u vervolgens op Implementeren in Azure Automation op de pagina met pakketgegevens. U wordt omgeleid naar de Azure Management Portal waar u zich aanmeldt met uw Azure-accountreferenties. Houd er rekening mee dat het implementeren van pakketten met afhankelijkheden alle afhankelijkheden implementeert in Azure Automation. De knop Implementeren in Azure Automation kan worden uitgeschakeld door de tag AzureAutomationNotSupported toe te voegen aan de metagegevens van uw pakket.

Zie de documentatie Azure Automation voor meer informatie over Azure Automation.

Als u pakketten wilt bijwerken die zijn geïnstalleerd vanuit de PowerShell Gallery, voert u de cmdlet Update-Module of Update-Script uit. Wanneer u zonder extra parameters wordt uitgevoerd, probeert Update-Module alle modules bij te werken die zijn geïnstalleerd door Install-Moduleuit te voeren. Als u modules selectief wilt bijwerken, voegt u de parameter -Name toe.

Op dezelfde manier probeert Update-Script bij uitvoering zonder extra parameters ook alle scripts bij te werken die zijn geïnstalleerd door Install-Scriptuit te voeren. Als u scripts selectief wilt bijwerken, voegt u de parameter -Name toe.

Als u wilt achterhalen welke modules u hebt geïnstalleerd vanuit de PowerShell Gallery, voert u de Get-InstalledModule-cmdlet uit. Met deze opdracht worden alle modules weergegeven die u op uw systeem hebt geïnstalleerd, rechtstreeks vanuit de PowerShell Gallery.

Als u wilt achterhalen welke scripts u hebt geïnstalleerd vanuit de PowerShell Gallery, voert u de Get-InstalledScript cmdlet uit. Met deze opdracht worden alle scripts weergegeven die u op uw systeem hebt geïnstalleerd, rechtstreeks vanuit de PowerShell Gallery.

Deze hostnamen moeten worden toegevoegd aan de acceptatielijsten die de toegang vanuit uw netwerk beheren.

Hosts vereist voor pakketdetectie en -download:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

Hosts die vereist zijn bij het gebruik van de Website van de PowerShell Gallery:

  • *.powershellgallery.com - website
  • go.microsoft.com en aka.ms - omleidingsservices

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Zie de aankondiging in de PowerShell-blog voor meer informatie.