Install-Script

Référence

Module:: PowerShellGet

Installe un script.

Syntax

Install-Script
       [-Name] <String[]>
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-RequiredVersion <String>]
       [-Repository <String[]>]
       [-Scope <String>]
       [-NoPathUpdate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-Credential <PSCredential>]
       [-Force]
       [-AllowPrerelease]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Script
       [-InputObject] <PSObject[]>
       [-Scope <String>]
       [-NoPathUpdate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-Credential <PSCredential>]
       [-Force]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet Install-Script de commande acquiert une charge utile de script à partir d’un dépôt, vérifie que la charge utile est un script PowerShell valide et copie le fichier de script vers un emplacement d’installation spécifié.

Les dépôts Install-Script par défaut sur sont configurables via les Register-PSRepositoryapplets de commande , Set-PSRepository, Unregister-PSRepositoryet Get-PSRepository . Lors de l’utilisation de plusieurs référentiels, Install-Script installe le premier script qui correspond aux critères de recherche spécifiés (Name, MinimumVersion ou MaximumVersion) à partir du premier dépôt sans erreur.

Exemples

Exemple 1 : Rechercher un script et l’installer

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2"
Version    Name                           Type       Repository           Description
-------    ----                           ----       ----------           -----------
2.5        Required-Script2               Script     local1               Description for the Required-Script2 script

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2" | Install-Script
PS C:\> Get-Command -Name "Required-Script2"
CommandType     Name                      Version    Source
-----------     ----                      -------    ------
ExternalScript  Required-Script2.ps1      2.0       C:\Users\pattif\Documents\WindowsPowerShell\Scripts\Required-Script2.ps1

PS C:\> Get-InstalledScript -Name "Required-Script2"
Version    Name                  Type     Repository           Description
-------    ----                  ----     ----------           -----------
2.5        Required-Script2      Script   local1               Description for the Required-Script2 script

PS C:\> Get-InstalledScript -Name "Required-Script2" | Format-List *
Name                       : Required-Script2
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script2 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:39 AM
LicenseUri                 : http://required-script2.com/license
ProjectUri                 : http://required-script2.com/
IconUri                    : http://required-script2.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script2-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script2 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Users\pattif\Documents\WindowsPowerShell\Scripts

La première commande recherche le script nommé Required-Script2 dans le référentiel Local1 et affiche les résultats.

La deuxième commande recherche le Required-Script2 script, puis utilise l’opérateur de pipeline pour le passer à l’applet de commande pour l’installer Install-Script .

La troisième commande utilise l’applet Get-Command de commande pour obtenir Required-Script2, puis affiche les résultats.

La quatrième commande utilise l’applet Get-InstalledScript de commande pour obtenir Required-Script2 et afficher les résultats.

La cinquième commande obtient Required-Script2 et utilise l’opérateur de pipeline pour la passer à l’applet de Format-List commande pour mettre en forme la sortie.

Exemple 2 : Installer un script avec l’étendue AllUsers

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script3" -Scope "AllUsers"
PS C:\> Get-InstalledScript -Name "Required-Script3"
Version    Name                  Type       Repository    Description
-------    ----                  ----       ----------    -----------
2.5        Required-Script3      Script     local1        Description for the Required-Script3 script

PS C:\> Get-InstalledScript -Name "Required-Script3" | Format-List *
Name                       : Required-Script3
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script3 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:45 AM
LicenseUri                 : http://required-script3.com/license
ProjectUri                 : http://required-script3.com/
IconUri                    : http://required-script3.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script3-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script3 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Program Files\WindowsPowerShell\Scripts

La première commande installe le script nommé Required-Script3 et lui attribue l’étendue AllUsers.

La deuxième commande obtient le script Required-Script3 installé et affiche des informations le concernant.

La troisième commande obtient Required-Script3 et utilise l’opérateur de pipeline pour la passer à l’applet de Format-List commande pour mettre en forme la sortie.

Exemple 3 : Installer un script et ses dépendances

PS C:\> Find-Script -Repository "Local1" -Name "Script-WithDependencies2" -IncludeDependencies
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Script-WithDependencies2"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script

PS C:\> Get-InstalledModule
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script*"
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script*"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

La première commande recherche le script nommé Script-WithDependencies2 et ses dépendances dans le référentiel Local1 et affiche les résultats.

La deuxième commande installe Script-WithDependencies2.

La troisième commande utilise l’applet de Get-InstalledScript commande de script pour obtenir les scripts installés et afficher les résultats.

La quatrième commande utilise l’applet de Get-InstalledModule commande pour installer les modules et afficher les résultats.

La cinquième commande utilise l’applet Find-Script de commande pour rechercher les scripts où le nom commence par Required-Script et afficher les résultats.

La sixième commande installe les scripts où le nom commence par Required-Script dans le référentiel Local1.

La commande finale obtient les scripts installés et affiche les résultats.

Paramètres

-AcceptLicense

Acceptez automatiquement le contrat de licence pendant l’installation si le module en a besoin.

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

-AllowPrerelease

Vous permet d’installer un script marqué comme une préversion.

Type:	SwitchParameter
Position:	Named
Default value:	None
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

Spécifie un compte d’utilisateur qui dispose des droits d’installation d’un script pour un fournisseur ou une source de package spécifié.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-InputObject

Utilisé pour l’entrée de pipeline. Une erreur est générée si une valeur fournie directement à InputObject. Utilisez le pipeline pour passer des objets avec le paramètre InputObject .

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

-MaximumVersion

Spécifie la version maximale d’un seul script à installer. Vous ne pouvez pas ajouter ce paramètre si vous tentez d’installer plusieurs scripts. Les paramètres MaximumVersion et RequiredVersion s’excluent mutuellement ; vous ne pouvez pas utiliser les deux paramètres dans la même commande.

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

-MinimumVersion

Spécifie la version minimale d’un script unique à installer. Vous ne pouvez pas ajouter ce paramètre si vous tentez d’installer plusieurs scripts. Les paramètres MinimumVersion et RequiredVersion s’excluent mutuellement ; vous ne pouvez pas utiliser les deux paramètres dans la même commande.

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

-Name

Spécifie un tableau de noms de scripts à installer.

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

-NoPathUpdate

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

-PassThru

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

-Proxy

Spécifie un serveur proxy pour la requête, plutôt que de se connecter directement à la ressource Internet.

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

-ProxyCredential

Spécifie un compte d'utilisateur qui a l'autorisation d'utiliser le serveur proxy spécifié par le paramètre Proxy.

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

-Repository

Spécifie le nom convivial d’un dépôt qui a été inscrit avec l’applet de Register-PSRepository commande . La valeur par défaut est tous les dépôts inscrits.

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

-RequiredVersion

Spécifie le numéro de version exact du script à installer.

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

-Scope

Spécifie l’étendue d’installation du script. Les valeurs valides sont : AllUsers et CurrentUser.

L’étendue AllUsers permet d’installer les modules dans un emplacement accessible à tous les utilisateurs de l’ordinateur, c’est-à-dire . $env:ProgramFiles\WindowsPowerShell\Scripts

L’étendue CurrentUser permet d’installer les modules uniquement sur $HOME\Documents\WindowsPowerShell\Scripts, afin que le module soit disponible uniquement pour l’utilisateur actuel.

Lorsqu’aucune étendue n’est définie, la valeur par défaut est définie en fonction de la session active :

Pour une session PowerShell avec élévation de privilèges, l’étendue est définie par défaut sur AllUsers ;
Pour les sessions PowerShell sans élévation de privilèges dans PowerShellGet versions 2.0.0 et ultérieures, l’étendue est CurrentUser ;
Pour les sessions PowerShell sans élévation de privilèges dans PowerShellGet versions 1.6.7 et antérieures, l’étendue n’est pas définie et Install-Module échoue.

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

PSObject[]

String

Uri

PSCredential

Sorties

Object

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Pour plus d’informations, consultez l’annonce sur le blog PowerShell.

Partager via

Install-Script

Syntax

Description

Exemples

Exemple 1 : Rechercher un script et l’installer

Exemple 2 : Installer un script avec l’étendue AllUsers

Exemple 3 : Installer un script et ses dépendances

Paramètres

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-WhatIf

Entrées

Sorties

Notes

Ressources supplémentaires

Partager via

Install-Script

Syntax

Description

Exemples

Exemple 1 : Rechercher un script et l’installer

Exemple 2 : Installer un script avec l’étendue AllUsers

Exemple 3 : Installer un script et ses dépendances

Paramètres

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-WhatIf

Entrées

Sorties

Notes

Liens associés

Ressources supplémentaires