Dela via

Install-PSResource

Modul:
Microsoft.PowerShell.PSResourceGet Module

Installerar resurser från en registrerad lagringsplats.

Syntax

NameParameterSet (Standard) 

Install-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet 

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet 

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet 

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Den här cmdleten installerar resurser från en registrerad lagringsplats till en installationssökväg på en dator. Som standard returnerar cmdleten inget objekt. Med andra parametrar kan du ange lagringsplatsen, omfånget och versionen för en resurs och ignorera licensmeddelanden.

Den här cmdleten kombinerar funktionerna i cmdletarna Install-Module och Install-Script från PowerShellGet v2.

Install-PSResource läser inte in den nyligen installerade modulen i den aktuella sessionen. Du måste importera den nya versionen eller starta en ny session för att använda den uppdaterade modulen. Mer information finns i Import-Module.

Anmärkning

Install-PSResource installerar inte beroende resurser från lagringsplatser som använder NuGet v3-protokollet. Du måste installera de beroende resurserna individuellt. Vi har för avsikt att lägga till den här funktionen i en framtida version.

Exempel

Exempel 1

Installerar den senaste stabila versionen (icke-förhandsversion) av modulen Az från PowerShell-galleriet.

Install-PSResource Az -Repository PSGallery

Az-modulen är en metamodul som innehåller alla Az PowerShell-moduler som beroenden. Det här kommandot installerar Az-modulen och alla dess beroenden.

Exempel 2

Installerar den senaste stabila Az-modulen mellan versionerna 7.3.0 och 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Exempel 3

Installerar den senaste stabila versionen av modulen Az. När parametern Installera om används skrivs cmdleten över en tidigare installerad version.

Install-PSResource Az -Reinstall

Exempel 4

Installerar PSResources som anges i psd1-filen.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exempel 5

Installerar DE PSResources som anges i hash-tabellen.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parametrar

-AcceptLicense

Anger att resursen ska acceptera alla begäranden om att godkänna licensavtalet. Detta förhindrar frågor om modulen kräver att en användare godkänner licensavtalet.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AuthenticodeCheck

Validerar Authenticode-signaturer och katalogfiler i Windows.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

Valfria autentiseringsuppgifter som används vid åtkomst till en lagringsplats.

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

Används för pipelineindata.

Parameteregenskaper

Typ:

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ParentResource (Föräldraresurs)

Parameteruppsättningar

InputObjectParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Namnet på en eller flera resurser som ska installeras.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NoClobber

Förhindrar installation av ett paket som innehåller cmdletar som redan finns på datorn.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

När det anges matar ett PSResourceInfo objekt för den sparade resursen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Prerelease

När detta anges innehåller förhandsversioner i sökresultat som returneras.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:ÄrFörhandsversion

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Quiet

Undertrycker förloppsindikatorn för installationen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Reinstall

Installerar den senaste versionen av en modul även om den senaste versionen redan är installerad. Den installerade versionen skrivs över. På så sätt kan du reparera en skadad installation av modulen.

Om en äldre version av modulen installeras installeras den nya versionen sida vid sida i en ny versionspecifik mapp.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Repository

Anger ett eller flera lagringsplatsnamn som ska sökas. Om det inte anges innehåller sökningen alla registrerade lagringsplatser i prioritetsordning (högst först) tills en lagringsplats hittas som innehåller paketet. Lagringsplatser sorteras efter prioritet och sedan efter namn. Lägre Prioritet värden har högre prioritet.

När du söker efter resurser på flera lagringsplatser söker PSResourceGet cmdlets i lagringsplatserna med den här sorteringsordningen. Install-PSResource installerar det första matchande paketet från den sorterade listan med lagringsplatser.

Parametern stöder * jokertecken. Om du anger flera lagringsplatser måste alla namn inkludera eller utelämna jokertecknet. Du kan inte ange en blandning av namn med och utan jokertecken.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
InputObjectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-RequiredResource

En hashtable- eller JSON-sträng som anger resurser som ska installeras. Jokertecken tillåts inte. En beskrivning av filformaten finns i avsnittet NOTES.

Parameteregenskaper

Typ:Object
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RequiredResourceParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RequiredResourceFile

Sökväg till en .psd1 eller .json som anger resurser som ska installeras. Jokertecken tillåts inte. En beskrivning av filformaten finns i avsnittet NOTES.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RequiredResourceFileParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Scope

Anger installationsomfånget. Godkända värden är:

  • CurrentUser
  • AllUsers

Standardomfånget är CurrentUser, som inte kräver utökade installationer.

Omfånget AllUsers installerar moduler på en plats som är tillgänglig för alla användare av datorn. Till exempel:

  • $env:ProgramFiles\PowerShell\Modules

CurrentUser installerar moduler på en plats som endast är tillgänglig för den aktuella användaren av datorn. Till exempel:

  • $home\Documents\PowerShell\Modules

Parameteregenskaper

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Standardvärde:None
Godkända värden:CurrentUser, AllUsers
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipDependencyCheck

Hoppar över kontrollen av resursberoenden. Endast hittade resurser är installerade. Inga resurser för den hittade resursen är installerade.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TemporaryPath

Anger sökvägen för att tillfälligt installera resursen innan den faktiska installationen. Om det inte finns någon tillfällig sökväg installeras resursen tillfälligt i den aktuella användarens temporära mapp.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TrustRepository

Ignorera uppmaningar om att lita på lagringsplatsen. Uppmaningen att lita på lagringsplatsen sker endast om lagringsplatsen inte är konfigurerad som betrodd.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Version

Anger vilken version av resursen som ska returneras. Värdet kan vara en exakt version eller ett versionsintervall med hjälp av NuGet-versionssyntaxen.

Mer information om NuGet-versionsintervall finns i Paketversioner.

PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Att använda 1.0.0.0 som version ger inte version 1.0.0.0 och högre (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inkluderande intervall använder du [1.0.0.0, ] som versionsintervall.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Utdata

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Som standard returnerar cmdleten inga objekt. När parametern PassThru används matar cmdleten ut ett PSResourceInfo- objekt för den sparade resursen.

Kommentarer

Modulen definierar isres som ett alias för Install-PSResource.

Parametrarna RequiredResource och RequiredResourceFil e används för att hitta PSResource- objekt som matchar specifika villkor. Du kan ange sökvillkoren med hjälp av en hashtable eller ett JSON-objekt. För parametern RequiredResourceFile lagras hashtabellen i en .psd1 fil och JSON-objektet lagras i en .json fil. Mer information finns i about_PSResourceGet.