Aracılığıyla paylaş


Install-Script

Bir betik yükler.

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

Install-Script Cmdlet bir depodan betik yükü alır, yükün geçerli bir PowerShell betiği olduğunu doğrular ve betik dosyasını belirtilen yükleme konumuna kopyalar.

Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Install-PSResource bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Install-PSResource.

Örnekler

Örnek 1: Betik bulma ve yükleme

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

İlk komut Local1 deposundan adlı Required-Script2 betiği bulur ve sonuçları görüntüler.

İkinci komut betiği bulur Required-Script2 ve ardından yüklemek üzere cmdlet'e geçirmek için Install-Script işlem hattı işlecini kullanır.

Üçüncü komut Get-Command , cmdlet'ini kullanarak öğesini alır Required-Script2ve sonuçları görüntüler.

Dördüncü komut, sonuçları almak Required-Script2 ve görüntülemek için cmdlet'ini kullanırGet-InstalledScript.

Beşinci komut, çıkışı biçimlendirmek üzere cmdlet'ine geçirmek için Format-List işlem hattı işlecini alır Required-Script2 ve kullanır.

Örnek 2: AllUsers kapsamına sahip bir betik yükleme

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

İlk komut adlı Required-Script3 betiği yükler ve AllUsers kapsamı atar.

İkinci komut yüklü betiği alır ve bu komutla Required-Script3 ilgili bilgileri görüntüler.

Üçüncü komut, çıkışı biçimlendirmek üzere cmdlet'ine geçirmek için Format-List işlem hattı işlecini alır Required-Script3 ve kullanır.

Örnek 3: Betiği ve bağımlılıklarını yükleme

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

İlk komut, adlı Script-WithDependencies2 betiği ve local1 deposundaki bağımlılıklarını bulur ve sonuçları görüntüler.

İkinci komut yükler Script-WithDependencies2.

Üçüncü komut, yüklü betikleri almak ve sonuçları görüntülemek için betik cmdlet'ini kullanır Get-InstalledScript .

Dördüncü komut, yüklü modülleri almak ve sonuçları görüntülemek için cmdlet'ini kullanır Get-InstalledModule .

Beşinci komut, adın Find-Script başladığı Required-Script betikleri bulmak ve sonuçları görüntülemek için cmdlet'ini kullanır.

Altıncı komut, adın Local1 deposunda ile başladığı Required-Script betikleri yükler.

Son komut yüklü betikleri alır ve sonuçları görüntüler.

Parametreler

-AcceptLicense

Modül gerekliyse, yükleme sırasında lisans sözleşmesini otomatik olarak kabul edin.

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

-AllowPrerelease

Ön sürüm olarak işaretlenmiş bir betik yüklemenize olanak tanır.

Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Install-PSResource.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Credential

Belirtilen paket sağlayıcısı veya kaynağı için betik yükleme hakları olan bir kullanıcı hesabını belirtir.

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

-Force

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-InputObject

İşlem hattı girişi için kullanılır. Doğrudan InputObject'e bir değer sağlandığında hata oluşur. InputObject parametresiyle nesneleri geçirmek için işlem hattını kullanın.

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

-MaximumVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-MinimumVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-Name

Yüklenecek betik adlarının dizisini belirtir.

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

-NoPathUpdate

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-PassThru

PassThru parametresini kullanırken, Install-Script modül için bir PSRepositoryItemInfo nesnesi çıkarır. Bu, cmdlet'ten edindiğiniz bilgilerle Find-Script aynıdır.

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

-Proxy

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-ProxyCredential

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-Repository

cmdlet'ine kaydedilmiş bir deponun Register-PSRepository kolay adını belirtir. Varsayılan olarak tüm kayıtlı depolar kullanılır.

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

-RequiredVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-Scope

Betiğin yükleme kapsamını belirtir. Geçerli değerler şunlardır: AllUsers ve CurrentUser.

AllUsers kapsamı, modüllerin bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yüklenmesine olanak tanır. $env:ProgramFiles\WindowsPowerShell\Scripts

CurrentUser kapsamı modüllerin yalnızca öğesine yüklenmesini $HOME\Documents\WindowsPowerShell\Scriptssağlar, böylece modül yalnızca geçerli kullanıcı tarafından kullanılabilir.

Kapsam tanımlanmadığında varsayılan ayar geçerli oturuma göre yapılır:

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

String[]

PSObject[]

String

Uri

PSCredential

Çıkışlar

Object

Notlar

Önemli

Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız, PowerShell Galerisi erişmeye çalışırken bir hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

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

Daha fazla bilgi için PowerShell blogundaki duyuruya bakın.