Aan de slag met de PowerShell Gallery

  • Artikel
  • 4 minuten om te lezen

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

Notitie

Het is mogelijk om een pakket rechtstreeks van de PowerShell Gallery downloaden, maar dit is geen aanbevolen aanpak. Zie Handmatig pakket downloaden voor meer informatie.

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

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

  • Name
  • AllVersions
  • Minimumversion
  • RequiredVersion
  • Tag
  • Includes
  • DscResource
  • RoleCapability
  • Opdracht
  • Filter

Als u alleen geïnteresseerd bent in het detecteren van specifieke DSC-resources in de galerie, kunt u de cmdlet Find-DscResource 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 misschien meer over weten. U kunt dit doen door de specifieke pagina van dat pakket in de galerie te bekijken. Op die pagina ziet u alle metagegevens 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 ontdekt dat een pakket naar uw idee niet goed is gepubliceerd, klikt u Misbruik melden op de pagina van dat pakket.

Als u Find-Module of Find-Script gebruikt, kunt u deze gegevens bekijken in het geretourneerde PSGetModuleInfo-object. Als u bijvoorbeeld wordt Find-Module -Name PSReadLine -Repository PSGallery |Get-Member uitgevoerd, worden gegevens in de module PSReadLine in de galerie als retourneert.

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

Inspecteren

Als u een pakket wilt downloaden uit de galerie voor inspectie, moet u de cmdlet Save-Module of Save-Script uitvoeren, afhankelijk van het pakkettype. Hiermee kunt u het pakket lokaal opslaan zonder het te installeren en de inhoud van het pakket 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 vóór de installatie te controleren.

Als u ontdekt dat een pakket naar uw idee niet goed is gepubliceerd, klikt u Misbruik melden op de pagina van dat pakket.

Installeren

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

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

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

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

Implementeren

Als u een pakket wilt implementeren vanuit PowerShell Gallery Azure Automation, klikt u op Azure Automation en vervolgens op Implementeren Azure Automation op de pagina met pakketdetails. U wordt omgeleid naar de Azure Beheerportal waar u zich aanmeldt met de referenties van uw Azure-account. Houd er rekening mee dat bij het implementeren van pakketten met afhankelijkheden alle afhankelijkheden worden geïmplementeerd 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 Azure Automation voor meer informatie over Azure Automation.

Als u pakketten wilt bijwerken die zijn geïnstalleerd PowerShell Gallery, moet u de cmdlet Update-Module of Update-Script uitvoeren. Bij het uitvoeren zonder extra parameters probeert Update-Module alle modules bij te werken die zijn geïnstalleerd door Install-Module uit te voeren. Als u modules selectief wilt bijwerken, voegt u de -Name parameter toe.

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

Voer de cmdlet Get-InstalledModule uit om te PowerShell Gallery welke modules u hebt geïnstalleerd. Met deze opdracht worden alle modules vermeld die u op uw systeem hebt die rechtstreeks vanuit de PowerShell Gallery.

Als u wilt weten welke scripts u hebt geïnstalleerd vanuit de PowerShell Gallery, moet u de cmdlet Get-InstalledScript uitvoeren. Met deze opdracht worden alle scripts vermeld die u op uw systeem hebt die rechtstreeks vanuit de PowerShell Gallery.

De PowerShell Gallery gebruikt de volgende hostnamen.

  • psg-prod-eastus.azureedge.net- CDN hostnaam
  • az818661.vo.msecnd.net- CDN hostnaam
  • devopsgallerystorage.blob.core.windows.net - hostnaam van opslagaccount
  • *.powershellgallery.com - website
  • go.microsoft.com - omleidingsservice

Deze hostnamen moeten worden toegevoegd aan de toegestane lijsten die de toegang vanaf uw netwerk bepalen.

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor Transport Layer Security versies 1.0 en 1.1 (TLS). Als u TLS 1.2 of hoger niet gebruikt, ontvangt 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.