Delen via

Aan de slag met de PowerShell Gallery

De PowerShell Gallery is een pakketopslagplaats met scripts, modules en DSC-bronnen die je 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.

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.

Nadat je een pakket hebt gekozen, wil je er misschien meer over leren. Bekijk de verpakkingspagina in de galerij. De pakketpagina bevat de metadata die met het pakket is geüpload. De metadata wordt geleverd door de auteur van het pakket. Microsoft verifieert deze informatie niet. De eigenaar van het pakket is gekoppeld aan het Galerijaccount dat werd gebruikt om het pakket te publiceren. Het Owner-account is gezaghebbender dan het Author-veld.

Als je een pakket vindt waarvan je vindt dat het niet te goeder trouw is uitgegeven, selecteer dan Misbruik melden 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

Om een pakket uit de Gallery te downloaden voor inspectie, gebruik je de Save-Module of Save-Script cmdlets op het pakket. Deze commando's slaan het pakket lokaal op zonder het te installeren. Controleer de inhoud van het pakket. Vergeet niet om het opgeslagen pakket handmatig te verwijderen.

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

Als je een pakket vindt waarvan je vindt dat het niet te goeder trouw is uitgegeven, selecteer dan Misbruik melden 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.

Standaard Install-Module wordt de module standaard op $env:ProgramFiles\WindowsPowerShell\Modules locatie geïnstalleerd, wat een beheerdersaccount vereist. Als je de -Scope CurrentUser parameter toevoegt, installeert het commando de module in $HOME\Documents\WindowsPowerShell\Modules .

Standaard Install-Script installeert het script op $env:ProgramFiles\WindowsPowerShell\Scripts locatie, wat een beheerdersaccount vereist. Als je de -Scope CurrentUser parameter toevoegt, installeert het commando het script in $HOME\Documents\WindowsPowerShell\Scripts.

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

Implementeren

Om een pakket uit te rollen vanuit de PowerShell Gallery naar Azure Automation, selecteer je Azure Automation en selecteer je vervolgens Deploy to Azure Automation op de pagina met pakketdetails. Je wordt doorgestuurd naar het Azure Management Portal waar je inlogt met je Azure-accountgegevens. Het uitrollen van pakketten met afhankelijkheden deployeert alle afhankelijkheden naar Azure Automation. De knop Deploy to Azure Automation kan worden uitgeschakeld door de tag AzureAutomationNotSupported toe te voegen aan je pakketmetadata.

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 uitgevoerd zonder andere parameters, Update-Module probeert men alle geïnstalleerde modules bij te werken door te draaien Install-Module. Als u modules selectief wilt bijwerken, voegt u de parameter -Name toe.

Evenzo, wanneer uitgevoerd zonder andere parameters, probeert het Update-Script ook alle geïnstalleerde scripts bij te werken door te draaien Install-Script. Als u scripts selectief wilt bijwerken, voegt u de parameter -Name toe.

Om te ontdekken welke modules je hebt geïnstalleerd uit de PowerShell Gallery, voer je 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.

Op dezelfde manier, om te ontdekken welke scripts je uit de PowerShell Gallery hebt geïnstalleerd, voer je 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.

Belangrijk

Voor de PowerShell-galerie is Transport Layer Security (TLS) 1.2 of hoger vereist. 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

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

Hosts vereist voor pakketdetectie en -download:

  • cdn.oneget.org
  • cdn.powershellgallery.com

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

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

Notitie

De oude eindpunten die eindigden op azureedge.net worden niet meer ondersteund.

  • Last updated on