Install-Script

Odwołanie

Moduł:: PowerShellGet

Instaluje skrypt.

Składnia

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

Opis

Polecenie Install-Script cmdlet uzyskuje ładunek skryptu z repozytorium, sprawdza, czy ładunek jest prawidłowym skryptem programu PowerShell i kopiuje plik skryptu do określonej lokalizacji instalacji.

To jest polecenie cmdlet serwera proxy dla Install-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Install-PSResource.

Przykłady

Przykład 1. Znajdowanie skryptu i instalowanie go

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

Pierwsze polecenie znajduje skrypt o nazwie Required-Script2 z repozytorium Local1 i wyświetla wyniki.

Drugie polecenie znajduje Required-Script2 skrypt, a następnie używa operatora potoku do przekazania go do Install-Script polecenia cmdlet w celu zainstalowania go.

Trzecie polecenie używa Get-Command polecenia cmdlet do pobrania Required-Script2, a następnie wyświetla wyniki.

Czwarte polecenie używa Get-InstalledScript polecenia cmdlet do pobrania Required-Script2 i wyświetlenia wyników.

Piąte polecenie pobiera Required-Script2 i używa operatora potoku do przekazania go do Format-List polecenia cmdlet w celu sformatowania danych wyjściowych.

Przykład 2. Instalowanie skryptu z zakresem 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

Pierwsze polecenie instaluje skrypt o nazwie Required-Script3 i przypisuje mu zakres AllUsers.

Drugie polecenie pobiera zainstalowany skrypt Required-Script3 i wyświetla informacje o nim.

Trzecie polecenie pobiera Required-Script3 i używa operatora potoku do przekazania go do Format-List polecenia cmdlet w celu sformatowania danych wyjściowych.

Przykład 3. Instalowanie skryptu i jego zależności

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

Pierwsze polecenie znajduje skrypt o nazwie Script-WithDependencies2 i jego zależności w repozytorium Local1 i wyświetla wyniki.

Drugie polecenie instaluje polecenie Script-WithDependencies2.

Trzecie polecenie używa polecenia cmdlet skryptu Get-InstalledScript do pobierania zainstalowanych skryptów i wyświetlania wyników.

Czwarte polecenie używa Get-InstalledModule polecenia cmdlet do pobierania zainstalowanych modułów i wyświetlania wyników.

Piąte polecenie używa Find-Script polecenia cmdlet do znajdowania skryptów, w których nazwa zaczyna się od Required-Script i wyświetla wyniki.

Szóste polecenie instaluje skrypty, w których nazwa zaczyna się od Required-Script w repozytorium Local1.

Ostatnie polecenie pobiera zainstalowane skrypty i wyświetla wyniki.

Parametry

-AcceptLicense

Automatycznie zaakceptuj umowę licencyjną podczas instalacji, jeśli moduł go wymaga.

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

-AllowPrerelease

Umożliwia zainstalowanie skryptu oznaczonego jako wydanie wstępne.

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr wersji wstępnej .Install-PSResource

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa konto użytkownika, które ma uprawnienia do instalowania skryptu dla określonego dostawcy pakietu lub źródła.

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

-Force

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Install-PSResourceprogram .

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

-InputObject

Służy do wprowadzania potoku. Błąd jest zgłaszany, jeśli wartość dostarczona bezpośrednio do obiektu InputObject. Użyj potoku, aby przekazać obiekty z parametrem InputObject .

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

-MaximumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru .Install-PSResource

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

-MinimumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru .Install-PSResource

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

-Name

Określa tablicę nazw skryptów do zainstalowania.

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

-NoPathUpdate

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Install-PSResourceprogram .

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

-PassThru

W przypadku korzystania z parametru Install-ScriptPassThru zwraca obiekt PSRepositoryItemInfo dla modułu. To są te same informacje, które otrzymujesz z Find-Script polecenia cmdlet.

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

-Proxy

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Install-PSResourceprogram .

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

-ProxyCredential

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Install-PSResourceprogram .

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

-Repository

Określa przyjazną nazwę repozytorium, które zostało zarejestrowane za pomocą Register-PSRepository polecenia cmdlet . Wartość domyślna to wszystkie zarejestrowane repozytoria.

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

-RequiredVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru .Install-PSResource

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

-Scope

Określa zakres instalacji skryptu. Prawidłowe wartości to: AllUsers i CurrentUser.

Zakres AllUsers umożliwia zainstalowanie modułów w lokalizacji dostępnej dla wszystkich użytkowników komputera, czyli $env:ProgramFiles\WindowsPowerShell\Scripts.

Zakres CurrentUser umożliwia instalowanie tylko modułów w $HOME\Documents\WindowsPowerShell\Scriptsprogramie , dzięki czemu moduł jest dostępny tylko dla bieżącego użytkownika.

Jeśli zakres nie jest zdefiniowany, wartość domyślna zostanie ustawiona na podstawie bieżącej sesji:

W przypadku sesji programu PowerShell z podwyższonym poziomem uprawnień zakres jest domyślnie ustawiona na AllUsers;
W przypadku sesji programu PowerShell bez podwyższonych uprawnień w programie PowerShellGet w wersji 2.0.0 lub nowszej zakres to CurrentUser;
W przypadku sesji programu PowerShell bez podwyższonych uprawnień w programie PowerShellGet w wersji 1.6.7 i starszych zakres jest niezdefiniowany i Install-Module kończy się niepowodzeniem.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String[]

PSObject[]

String

Uri

PSCredential

Dane wyjściowe

Object

Uwagi

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.

Install-Script

Składnia

Opis

Przykłady

Przykład 1. Znajdowanie skryptu i instalowanie go

Przykład 2. Instalowanie skryptu z zakresem AllUsers

Przykład 3. Instalowanie skryptu i jego zależności

Parametry

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Opinia

Dodatkowe zasoby

Install-Script

Składnia

Opis

Przykłady

Przykład 1. Znajdowanie skryptu i instalowanie go

Przykład 2. Instalowanie skryptu z zakresem AllUsers

Przykład 3. Instalowanie skryptu i jego zależności

Parametry

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Opinia

Dodatkowe zasoby