Install-PSResource

Syntaxe

NameParameterSet (Par défaut)

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

InputObjectParameterSet

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

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <string>
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

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

Description

Exemples

Exemple 1

Install-PSResource Az -Repository PSGallery

Exemple 2

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

Exemple 3

Install-PSResource Az -Reinstall

Exemple 4

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemple 5

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ètres

-AcceptLicense

Spécifie que la ressource doit accepter toute demande d’acceptation du contrat de licence. Cela supprime l’invite si le module impose à un utilisateur d’accepter le contrat de licence.

Propriétés du paramètre

Jeux de paramètres

-AuthenticodeCheck

Valide les signatures Authenticode et les fichiers catalogue sur Windows.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Credential

Informations d’identification facultatives utilisées lors de l’accès à un référentiel.

Propriétés du paramètre

Jeux de paramètres

-InputObject

Utilisé pour l’entrée de pipeline.

Propriétés du paramètre

Jeux de paramètres

-Name

Nom d’une ou plusieurs ressources à installer.

Propriétés du paramètre

Jeux de paramètres

-NoClobber

Empêche l’installation d’un package qui contient des applets de commande qui existent déjà sur l’ordinateur.

Propriétés du paramètre

Jeux de paramètres

-PassThru

Quand elle est spécifiée, génère un objet PSResourceInfo pour la ressource enregistrée.

Propriétés du paramètre

Jeux de paramètres

-Prerelease

Quand elle est spécifiée, inclut des versions préliminaires dans les résultats de recherche retournés.

Propriétés du paramètre

Jeux de paramètres

-Quiet

Supprime la barre de progression de l’installation.

Propriétés du paramètre

Jeux de paramètres

-Reinstall

Installe la dernière version d’un module, même si la dernière version est déjà installée. La version installée est remplacée. Cela vous permet de réparer une installation endommagée du module.

Si vous avez une version plus ancienne du module installée, la nouvelle version est installée côte à côte dans un dossier spécifique à chaque version.

Propriétés du paramètre

Jeux de paramètres

-Repository

Spécifie un ou plusieurs noms de référentiels à rechercher. Si elle n’est pas spécifiée, la recherche inclut tous les référentiels inscrits, dans l’ordre de priorité (le plus élevé), jusqu’à ce qu’un référentiel soit trouvé qui contient le package. Les référentiels sont triés par priorité, puis par nom. Les valeurs Priorité inférieure ont une priorité plus élevée.

Lors de la recherche de ressources sur plusieurs référentiels, les applets de commande PSResourceGet recherchent les référentiels à l’aide de cet ordre de tri. Install-PSResource installe le premier package correspondant à partir de la liste triée des référentiels.

Le paramètre prend en charge le caractère générique *. Si vous spécifiez plusieurs référentiels, tous les noms doivent inclure ou omettre le caractère générique. Vous ne pouvez pas spécifier de combinaison de noms avec et sans caractères génériques.

Propriétés du paramètre

Jeux de paramètres

-RequiredResource

Chaîne de hachage ou JSON qui spécifie les ressources à installer. Les caractères génériques ne sont pas autorisés. Consultez la section NOTES pour obtenir une description des formats de fichier.

Propriétés du paramètre

Jeux de paramètres

-RequiredResourceFile

Chemin d’accès à un .psd1 ou .json qui spécifie les ressources à installer. Les caractères génériques ne sont pas autorisés. Consultez la section NOTES pour obtenir une description des formats de fichier.

Propriétés du paramètre

Jeux de paramètres

-RuntimeIdentifier

Spécifie l’identifiant d’exécution (RID) pour filtrer les actifs spécifiques à la plateforme. Lorsqu’elle est spécifiée, la commande n’installe que les assets d’exécution correspondant à ce RID au lieu de la plateforme autodétectée. Vous pouvez l’utiliser pour des scénarios de déploiement multiplateforme, par exemple en préparant un paquet Linux depuis Windows. La commande prend en charge les valeurs RID suivantes issues du catalogue .NET RID :

• linux-arm
• linux-arm64
• linux-musl-arm64
• linux-musl-x64
• linux-x64
• osx-arm64
• osx-x64
• win-arm64
• win-x64
• win-x86

Propriétés du paramètre

Jeux de paramètres

-Scope

Spécifie l’étendue d’installation. Les valeurs acceptées sont les suivantes :

• CurrentUser
• AllUsers

L’étendue par défaut est CurrentUser, qui ne nécessite pas d’élévation pour l’installation.

L’étendue AllUsers installe des modules dans un emplacement accessible à tous les utilisateurs de l’ordinateur. Par exemple:

• $env:ProgramFiles\PowerShell\Modules

Le CurrentUser installe des modules dans un emplacement accessible uniquement à l’utilisateur actuel de l’ordinateur. Par exemple:

• $home\Documents\PowerShell\Modules

Propriétés du paramètre

Jeux de paramètres

-SkipDependencyCheck

Ignore la vérification des dépendances de ressources. Seules les ressources trouvées sont installées. Aucune ressource de la ressource trouvée n’est installée.

Propriétés du paramètre

Jeux de paramètres

-TargetFramework

Spécifie le Target Framework Moniker (TFM) à sélectionner pour le lib/ filtrage des dossiers. Lorsqu’elle est spécifiée, la commande n’installe que les lib/ assets correspondant à ce TFM au lieu du cadre autodétecté. Vous pouvez l’utiliser pour des scénarios de déploiement multiplateforme, par exemple en préparant un paquet Linux depuis Windows. La commande prend en charge les valeurs TFM suivantes :

• net48
• net6.0
• net7.0
• net8.0
• net9.0
• net10.0
• netstandard2.0
• netstandard2.1

Propriétés du paramètre

Jeux de paramètres

-TemporaryPath

Spécifie le chemin d’accès pour installer temporairement la ressource avant l’installation réelle. Si aucun chemin temporaire n’est fourni, la ressource est temporairement installée dans le dossier temporaire de l’utilisateur actuel.

Propriétés du paramètre

Jeux de paramètres

-TrustRepository

Supprimez les invites pour approuver le référentiel. L’invite à approuver le référentiel se produit uniquement si le référentiel n’est pas configuré comme approuvé.

Propriétés du paramètre

Jeux de paramètres

-Version

Spécifie la version de la ressource à retourner. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.

Pour plus d’informations sur les plages de versions NuGet, consultez de contrôle de version du package.

PowerShellGet prend en charge toutes les versions inclusives minimum répertoriées dans la documentation de la plage de versions NuGet. L’utilisation de 1.0.0.0 car la version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notes

Liens associés

• Versionnement des paquets
• Uninstall-PSResource
• Frameworks cibles dans les projets de type kit SDK
• Catalogue d’identificateurs de runtime (RID) .NET