Install-PSResource
Erőforrásokat telepít egy regisztrált adattárból.
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
Ez a parancsmag erőforrásokat telepít egy regisztrált adattárból egy számítógépen lévő telepítési útvonalra. Alapértelmezés szerint a parancsmag nem ad vissza objektumot. Más paraméterekkel megadhatja az erőforrás adattárát, hatókörét és verzióját, és letilthatja a licenckérdéseket.
Ez a parancsmag egyesíti a Install-Module
PowerShellGet v2-ből származó és Install-Script
parancsmagok funkcióit.
Példák
1\. példa
Telepíti az Az modul legújabb stabil (nem előzetes) verzióját.
Install-PSResource Az
2\. példa
Telepíti a legújabb stabil Az modult a verziók 7.3.0
és 8.3.0
között.
Install-PSResource Az -Version '[7.3.0, 8.3.0]'
3\. példa
Telepíti az Az modul legújabb stabil verzióját. Az Újratelepítés paraméter használata esetén a parancsmag a korábban telepített verziókra ír.
Install-PSResource Az -Reinstall
4\. példa
Telepíti a psd1 fájlban megadott PSResource-okat.
Install-PSResource -RequiredResourceFile myRequiredModules.psd1
5\. példa
Telepíti a kivonattáblában megadott PSResource-okat.
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 = @{}
}
Paraméterek
-AcceptLicense
Meghatározza, hogy az erőforrásnak el kell fogadnia a licencszerződés elfogadására vonatkozó kéréseket. Ez letiltja a kérést, ha a modul arra kötelezi a felhasználót, hogy fogadja el a licencszerződést.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Ellenőrzi az Authenticode aláírásokat és a katalógusfájlokat Windows rendszeren.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Az adattárak eléréséhez használt opcionális hitelesítő adatok.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Folyamatbemenethez használatos.
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Egy vagy több telepítendő erőforrás neve.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Megakadályozza a számítógépen már létező parancsmagokat tartalmazó csomagok telepítését.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Ha meg van adva, egy PSResourceInfo objektumot ad ki a mentett erőforráshoz.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Ha meg van adva, előzetes verziókat is tartalmaz a visszaadott keresési eredményekben.
Type: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Letiltja a telepítési folyamatjelzőt.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reinstall
Akkor is telepíti a modul legújabb verzióját, ha a legújabb verzió már telepítve van. A telepített verzió felül lesz írva. Ez lehetővé teszi a modul sérült telepítésének javítását.
Ha a modul egy régebbi verziója van telepítve, az új verzió párhuzamosan települ egy új verzióspecifikus mappába.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repository
Egy vagy több keresendő adattárnevet ad meg. Ha nincs megadva, a keresés az összes regisztrált adattárat prioritási sorrendben (elsőként a legmagasabb) tartalmazza, amíg meg nem találja a csomagot tartalmazó adattárat. Az adattárak prioritás, majd név szerint vannak rendezve. Az alacsonyabb prioritású értékek elsőbbséget élveznek.
Ha több adattárban keres erőforrásokat, a PSResourceGet-parancsmagok ezzel a rendezési sorrendben keresik az adattárakat. Install-PSResource
Telepíti az első egyező csomagot az adattárak rendezett listájából.
A paraméter támogatja a *
helyettesítő karaktert. Ha több adattárat ad meg, az összes névnek tartalmaznia kell a helyettesítő karaktert, vagy el kell kihagynia azt. Helyettesítő karakterekkel és anélkül nem adhatja meg a nevek kombinációját.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-RequiredResource
Egy kivonatoló vagy JSON-sztring, amely megadja a telepíteni kívánt erőforrásokat. A helyettesítő karakterek nem használhatók. A fájlformátumok leírását a JEGYZETEK szakaszban találja.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredResourceFile
.psd1
A telepítendő erőforrásokat meghatározó vagy .json
elérési út. A helyettesítő karakterek nem használhatók. A fájlformátumok leírását a JEGYZETEK szakaszban találja.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Megadja a telepítési hatókört. Az elfogadott értékek a következők:
CurrentUser
AllUsers
Az alapértelmezett hatókör a CurrentUser
, amely nem igényel jogosultságszint-emelést a telepítéshez.
A AllUsers
hatókör olyan helyre telepíti a modulokat, amely a számítógép összes felhasználója számára elérhető. Például:
$env:ProgramFiles\PowerShell\Modules
A CurrentUser
modulok telepítése olyan helyen, amely csak a számítógép aktuális felhasználója számára érhető el. Például:
$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
Kihagyja az erőforrás-függőségek ellenőrzését. Csak a talált erőforrások vannak telepítve. Nincs telepítve a talált erőforrás erőforrása.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryPath
Megadja az erőforrás tényleges telepítés előtti ideiglenes telepítésének elérési útját. Ha nincs megadva ideiglenes elérési út, az erőforrás ideiglenesen települ az aktuális felhasználó ideiglenes mappájába.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
Tiltsa le a megbízható adattárra vonatkozó kéréseket. A megbízhatósági kérés csak akkor jelenik meg, ha az adattár nincs megbízhatóként konfigurálva.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
A visszaadni kívánt erőforrás verzióját adja meg. Az érték lehet pontos verzió vagy verziótartomány a NuGet verziószámozási szintaxisával.
További információ a NuGet-verziótartományokról: Csomagverzió-készítés.
A PowerShellGet a NuGet-verziótartomány dokumentációjában felsorolt minimális befogadó verzión kívül az összeset támogatja. A verzióként való használat 1.0.0.0
nem eredményez 1.0.0.0-s vagy újabb verziót (minimális befogadó tartomány). Ehelyett a rendszer a szükséges verziónak tekinti az értéket. A minimális befogadó tartomány kereséséhez használja [1.0.0.0, ]
a verziótartományt.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Kimenetek
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Alapértelmezés szerint a parancsmag nem ad vissza objektumokat. A PassThru paraméter használatakor a parancsmag egy PSResourceInfo objektumot ad ki a mentett erőforráshoz.
Jegyzetek
A modul aliasként definiálja isres
a következőt: Install-PSResource
.
A RequiredResource és a RequiredResourceFile paraméterekkel megkereshetőek az adott feltételeknek megfelelő PSResource-objektumok . A keresési feltételeket hashtable vagy JSON-objektum használatával adhatja meg. A RequiredResourceFile paraméter esetében a kivonattábla egy .psd1
fájlban, a JSON-objektum pedig egy .json
fájlban van tárolva. További információ: about_PSResourceGet.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: