Install-PSResource

Référence

Module:: Microsoft.PowerShell.PSResourceGet

Installe des ressources à partir d’un dépôt inscrit.

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

Cette applet de commande installe les ressources d’un dépôt 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 dépôt, 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 de PowerShellGet v2.

Exemples

Exemple 1

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

Install-PSResource Az

Exemple 2

Installe le dernier module stable Az dans le entre 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 ressources PSResources spécifiées dans le fichier psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemple 5

Installe les ressources PSResources spécifiées 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 exige qu’un utilisateur accepte le contrat de licence.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthenticodeCheck

Valide les signatures Authenticode et les fichiers catalogue sur Windows.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Informations d’identification facultatives utilisées lors de l’accès à un dépôt.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Utilisé pour l’entrée de pipeline.

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nom d’une ou plusieurs ressources à installer.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Lorsqu’il est spécifié, génère un objet PSResourceInfo pour la ressource enregistrée.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Prerelease

Lorsqu’il est spécifié, inclut les versions préliminaires dans les résultats de recherche retournés.

Type:	SwitchParameter
Aliases:	IsPrerelease
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Quiet

Supprime la barre de progression de l’installation.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 dossier spécifique à la nouvelle version.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 dépôts inscrits, dans l’ordre de priorité (le plus élevé en premier), jusqu’à ce qu’un dépôt contenant le package soit trouvé. Les dépôts sont triés par priorité, puis par nom. Les valeurs de priorité inférieure ont une priorité plus élevée.

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

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 une combinaison de noms avec et sans caractères génériques.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-RequiredResource

Une table de hachage ou une chaîne 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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 les modules dans un emplacement accessible à tous les utilisateurs de l’ordinateur. Par exemple :

$env:ProgramFiles\PowerShell\Modules

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

$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

Ignore la case activée pour les 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
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemporaryPath

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustRepository

Supprimez les invites à approuver le dépôt. L’invite à approuver le dépôt se produit uniquement si le dépôt n’est pas configuré comme approuvé.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 des packages.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Install-PSResource

Syntax

Description

Exemples

Exemple 1

Exemple 2

Exemple 3

Exemple 4

Exemple 5

Paramètres

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Entrées

Sorties

Notes

Commentaires

Ressources supplémentaires

Install-PSResource

Syntax

Description

Exemples

Exemple 1

Exemple 2

Exemple 3

Exemple 4

Exemple 5

Paramètres

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Entrées

Sorties

Notes

Liens associés

Commentaires

Ressources supplémentaires