Install-PSResource

Başvuru

Modül:: Microsoft.PowerShell.PSResourceGet

Kayıtlı bir depodan kaynakları yükler.

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

Bu cmdlet, kaynakları kayıtlı bir depodan makinedeki yükleme yoluna yükler. Varsayılan olarak, cmdlet herhangi bir nesne döndürmez. Diğer parametreler, bir kaynağın deposunu, kapsamını ve sürümünü belirtmenize ve lisans istemlerini engellemenize olanak sağlar.

Bu cmdlet, PowerShellGet v2'den ve Install-Script cmdlet'lerinin işlevlerini Install-Module birleştirir.

Örnekler

Örnek 1

Az modülünün en son kararlı (yayın öncesi olmayan) sürümünü yükler.

Install-PSResource Az

Örnek 2

ile arasındaki sürümler 7.3.0 içinde en son kararlı Az modülünü yükler.8.3.0

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

Örnek 3

Az modülünün en son kararlı sürümünü yükler. Reinstall parametresi kullanıldığında, cmdlet önceden yüklenmiş herhangi bir sürümün üzerine yazar.

Install-PSResource Az -Reinstall

Örnek 4

psd1 dosyasında belirtilen PSResources'u yükler.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Örnek 5

Karma tablo içinde belirtilen PSResources'u yükler.

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 = @{}
}

Parametreler

-AcceptLicense

Kaynağın lisans sözleşmesini kabul etme isteğini kabul etmesi gerektiğini belirtir. Bu, modülün kullanıcının lisans sözleşmesini kabul etme zorunlu olup olmadığını sormayı bastırır.

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

-AuthenticodeCheck

Windows'da Authenticode imzalarını ve katalog dosyalarını doğrular.

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

Bir depoya erişirken kullanılan isteğe bağlı kimlik bilgileri.

Type:	PSCredential
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.

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

-Name

Yüklenecek bir veya daha fazla kaynağın adı.

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

-NoClobber

Makinede zaten var olan cmdlet'leri içeren bir paketin yüklenmesini engeller.

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

-PassThru

Belirtildiğinde, kaydedilen kaynak için bir PSResourceInfo nesnesi oluşturur.

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

-Prerelease

Belirtildiğinde, döndürülen arama sonuçlarına yayın öncesi sürümleri ekler.

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

-Quiet

Yükleme ilerleme çubuğunu gizler.

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

-Reinstall

En son sürüm zaten yüklü olsa bile modülün en son sürümünü yükler. Yüklü sürümün üzerine yazılır. Bu sayede modülün hasarlı yüklemesini onarabilirsiniz.

Modülün eski bir sürümü yüklüyse, yeni sürüm yeni sürüme özgü bir klasöre yan yana yüklenir.

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

-Repository

Aranacak bir veya daha fazla depo adını belirtir. Belirtilmezse, paketi içeren bir depo bulunana kadar arama tüm kayıtlı depoları öncelik sırasına göre (en yüksek önce) içerir. Depolar önceliğe ve ardından ada göre sıralanır. Düşük Öncelik değerleri daha yüksek önceliğe sahiptir.

PsResourceGet cmdlet'leri, birden çok depodaki kaynakları ararken bu sıralama düzenini kullanarak depolarda arama uygular. Install-PSResource sıralanmış depo listesinden eşleşen ilk paketi yükler.

parametresi joker karakteri destekler * . Birden çok depo belirtirseniz, tüm adlar joker karakteri içermelidir veya atlanmalıdır. Joker karakterlerle ve joker karakterler olmadan adların karışımını belirtemezsiniz.

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

-RequiredResource

Yüklenecek kaynakları belirten bir karma tablo veya JSON dizesi. Joker karakterlere izin verilmez. Dosya biçimlerinin açıklaması için NOTLAR bölümüne bakın.

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

-RequiredResourceFile

Yüklenecek kaynakları belirten bir .psd1 veya .json yolu. Joker karakterlere izin verilmez. Dosya biçimlerinin açıklaması için NOTLAR bölümüne bakın.

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

-Scope

Yükleme kapsamını belirtir. Kabul edilen değerler şunlardır:

CurrentUser
AllUsers

Varsayılan kapsam, yükleme için yükseltme gerektirmeyen şeklindedir CurrentUser.

Kapsam AllUsers , modülleri bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yükler. Örnek:

$env:ProgramFiles\PowerShell\Modules

modüllerini CurrentUser yalnızca bilgisayarın geçerli kullanıcısı tarafından erişilebilen bir konuma yükler. Örnek:

$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

Kaynak bağımlılıkları denetimini atlar. Yalnızca bulunan kaynaklar yüklenir. Bulunan kaynağın hiçbir kaynağı yüklenmez.

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

-TemporaryPath

Gerçek yüklemeden önce kaynağın geçici olarak yükleneceği yolu belirtir. Geçici yol sağlanmazsa, kaynak geçerli kullanıcının geçici klasörüne geçici olarak yüklenir.

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

-TrustRepository

Depoya güvenme istemlerini bastır. Depoya güvenme istemi yalnızca deponun güvenilir olarak yapılandırılmamış olması durumunda oluşur.

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

-Version

Döndürülecek kaynağın sürümünü belirtir. Değer, NuGet sürüm oluşturma söz dizimini kullanarak tam bir sürüm veya sürüm aralığı olabilir.

NuGet sürüm aralıkları hakkında daha fazla bilgi için bkz. Paket sürümü oluşturma.

PowerShellGet, NuGet sürüm aralığı belgelerinde listelenen en düşük dahil sürüm hariç tüm sürümleri destekler. sürüm olarak kullanılması 1.0.0.0 1.0.0.0 ve üzeri sürümleri (en düşük kapsayıcı aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsayıcı aralığı aramak için sürüm aralığı olarak kullanın [1.0.0.0, ] .

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

-WhatIf

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

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

Girişler

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Çıkışlar

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Varsayılan olarak, cmdlet herhangi bir nesne döndürmez. PassThru parametresi kullanıldığında, cmdlet kaydedilen kaynak için bir PSResourceInfo nesnesi oluşturur.

Notlar

modülü için Install-PSResourcediğer ad olarak tanımlarisres.

RequiredResource ve RequiredResourceFile parametreleri, belirli ölçütlerle eşleşen PSResource nesnelerini bulmak için kullanılır. Arama ölçütlerini bir karma tablo veya JSON nesnesi kullanarak belirtebilirsiniz. RequiredResourceFile parametresi için hashtable bir .psd1 dosyada depolanır ve JSON nesnesi bir .json dosyada depolanır. Daha fazla bilgi için bkz. about_PSResourceGet.

Install-PSResource

Syntax

Description

Örnekler

Örnek 1

Örnek 2

Örnek 3

Örnek 4

Örnek 5

Parametreler

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Install-PSResource

Syntax

Description

Örnekler

Örnek 1

Örnek 2

Örnek 3

Örnek 4

Örnek 5

Parametreler

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar