Install-PSResource

Module:

Microsoft.PowerShell.PSResourceGet

Installe des ressources à partir d’un référentiel inscrit.

Syntaxe

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

Cette applet de commande installe les ressources d’un référentiel inscrit vers un chemin d’installation sur un ordinateur. Par défaut, l’applet de commande ne retourne aucun objet. D’autres paramètres vous permettent de spécifier le référentiel, l’étendue et la version d’une ressource et de supprimer les invites de licence.

Cette applet de commande combine les fonctions des applets de Install-Module commande et Install-Script des applets de commande de PowerShellGet v2.

Install-PSResource ne charge pas le module nouvellement installé dans la session active. Vous devez importer la nouvelle version ou démarrer une nouvelle session pour utiliser le module mis à jour. Pour plus d’informations, voir Import-Module.

Exemples

Exemple 1

Installe la dernière version stable (sans préversion) du module Az .

Install-PSResource Az

Exemple 2

Installe le dernier module Az stable dans les versions 7.3.0 et 8.3.0.

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

Exemple 3

Installe la dernière version stable du module Az . Lorsque le paramètre Réinstaller est utilisé, l’applet de commande écrit sur n’importe quelle version précédemment installée.

Install-PSResource Az -Reinstall

Exemple 4

Installe les PSResources spécifiés dans le fichier psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemple 5

Installe les psResources spécifiés dans la table de hachage.

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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AuthenticodeCheck

Valide les signatures Authenticode et les fichiers catalogue sur Windows.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Credential

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

Type:	PSCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Utilisé pour l’entrée de pipeline.

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Alias:	ParentResource
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Nom d’une ou plusieurs ressources à installer.

Type:	String[]
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-NoClobber

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Prerelease

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

Type:	SwitchParameter
Alias:	IsPrerelease
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Quiet

Supprime la barre de progression de l’installation.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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 de priorité inférieure ont une priorité plus élevée.

Lorsque vous recherchez des ressources dans 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.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	True

-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.

Type:	Object
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Scope

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

• 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

Les CurrentUser modules installent dans un emplacement accessible uniquement à l’utilisateur actuel de l’ordinateur. Par exemple :

• $home\Documents\PowerShell\Modules

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valeurs acceptées:	CurrentUser, AllUsers
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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é.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-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 Gestion des versions du package.

PowerShellGet prend en charge toutes les versions inclusives minimales répertoriées dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 comme 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, ] la plage de versions.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	True

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Par défaut, l’applet de commande ne retourne aucun objet. Lorsque le paramètre PassThru est utilisé, l’applet de commande génère un objet PSResourceInfo pour la ressource enregistrée.

Notes

Le module définit isres comme alias pour Install-PSResource.

Les paramètres RequiredResource et RequiredResourceFile sont utilisés pour rechercher des objets PSResource correspondant à des critères spécifiques. Vous pouvez spécifier les critères de recherche à l’aide d’une table de hachage ou d’un objet JSON. Pour le paramètre RequiredResourceFile , la table de hachage est stockée dans un .psd1 fichier et l’objet JSON est stocké dans un .json fichier. Pour plus d’informations, consultez about_PSResourceGet.

Liens associés

• Contrôle de version des packages
• Uninstall-PSResource