Install-PSResource
Installerar resurser från en registrerad lagringsplats.
Syntax
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>]
Install-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResourceFile <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResource <Object>
[-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 inga objekt. Med andra parametrar kan du ange lagringsplats, omfång och version för en resurs och utelämna licensuppaningar.
Den här cmdleten kombinerar funktionerna i Install-Module
cmdletarna och Install-Script
från PowerShellGet v2.
Exempel
Exempel 1
Installerar den senaste stabila versionen (icke-förhandsversion) av Az-modulen.
Install-PSResource Az
Exempel 2
Installerar den senaste stabila Az-modulen i mellanversionerna 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 Az-modulen . När parametern Reinstall används skriver cmdleten över alla tidigare installerade versioner.
Install-PSResource Az -Reinstall
Exempel 4
Installerar PSResources som anges i psd1-filen.
Install-PSResource -RequiredResourceFile myRequiredModules.psd1
Exempel 5
Installerar 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 undertrycker frågor om modulen kräver att en användare godkänner licensavtalet.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Validerar Authenticode-signaturer och katalogfiler i Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Valfria autentiseringsuppgifter som används vid åtkomst till en lagringsplats.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Används för pipelineindata.
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Namnet på en eller flera resurser som ska installeras.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Förhindrar installation av ett paket som innehåller cmdletar som redan finns på datorn.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
När detta anges matar ut ett PSResourceInfo-objekt för den sparade resursen.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
När detta anges innehåller förhandsversioner i sökresultat som returneras.
Type: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Undertrycker förloppsindikatorn för installationen.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repository
Anger ett eller flera namn på lagringsplatsen som ska sökas. Om inget anges inkluderar 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 prioritetsvärden har högre prioritet.
När du söker efter resurser på flera lagringsplatser söker PSResourceGet-cmdletarna i lagringsplatserna med hjälp av den här sorteringsordningen. Install-PSResource
installerar det första matchande paketet från den sorterade listan över lagringsplatser.
Parametern stöder *
jokertecknet. Om du anger flera lagringsplatser måste alla namn innehålla eller utelämna jokertecknet. Du kan inte ange en blandning av namn med och utan jokertecken.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-RequiredResource
En hashtable- eller JSON-sträng som anger resurser som ska installeras. Jokertecken tillåts inte. En beskrivning av filformaten finns i avsnittet ANTECKNINGAR .
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 ANTECKNINGAR .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Exempel:
$env:ProgramFiles\PowerShell\Modules
Installerar CurrentUser
moduler på en plats som endast är tillgänglig för den aktuella användaren av datorn. Exempel:
$home\Documents\PowerShell\Modules
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencyCheck
Hoppar över kontrollen av resursberoenden. Endast hittade resurser installeras. Inga resurser för den hittade resursen har installerats.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryPath
Anger sökvägen för att tillfälligt installera resursen före den faktiska installationen. Om ingen tillfällig sökväg anges installeras resursen tillfälligt i den aktuella användarens temporära mapp.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
Ignorera uppmaningar om att lita på lagringsplatsen. Uppmaningen att lita på lagringsplatsen sker bara om lagringsplatsen inte är konfigurerad som betrodd.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Anger vilken version av resursen som ska returneras. Värdet kan vara en exakt version eller ett versionsintervall med hjälp av syntaxen för NuGet-versionshantering.
Mer information om NuGet-versionsintervall finns i Paketversionshantering.
PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Användning 1.0.0.0
som version ger inte versionerna 1.0.0.0 och senare (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inklusivintervall använder [1.0.0.0, ]
du som versionsintervall.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
String[]
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 RequiredResourceFile används för att hitta PSResource-objekt som matchar specifika villkor. Du kan ange sökvillkoren med hjälp av en hashtabell 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.
Relaterade länkar
PSResourceGet
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för