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]
    [-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

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

Jeux de paramètres

-AuthenticodeCheck

Valide les signatures Authenticode et les fichiers catalogue sur Windows.

Propriétés des paramètres

Jeux de paramètres

-Confirm

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

Propriétés des paramètres

Jeux de paramètres

-Credential

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

Propriétés des paramètres

Jeux de paramètres

-InputObject

Utilisé pour l’entrée de pipeline.

Propriétés des paramètres

Jeux de paramètres

-Name

Nom d’une ou plusieurs ressources à installer.

Propriétés des paramètres

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

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

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

Jeux de paramètres

-Quiet

Supprime la barre de progression de l’installation.

Propriétés des paramètres

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 une version antérieure du module est installée, la nouvelle version est installée côte à côte dans un nouveau dossier spécifique à la version.

Propriétés des paramètres

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

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

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

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

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

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

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

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

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

Jeux de paramètres

CommonParameters

Entrées

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notes

Liens connexes

• Versionnement des paquets
• Uninstall-PSResource