Register-PSResourceRepository

PowerShell kaynakları için bir depo kaydeder.

Sözdizimi

Register-PSResourceRepository
        [-Name] <String>
        [-Uri] <String>
        [-Trusted]
        [-Priority <Int32>]
        [-ApiVersion <APIVersion>]
        [-CredentialInfo <PSCredentialInfo>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Register-PSResourceRepository
        [-PSGallery]
        [-Trusted]
        [-Priority <Int32>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Register-PSResourceRepository
        -Repository <Hashtable[]>
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Description

Cmdlet, PowerShell kaynaklarını içeren bir NuGet deposu kaydeder.

Örnekler

Örnek 1

Bu örnek, depoyu Adı PoshTestGalleryile kaydeder.

Register-PSResourceRepository -Name PoshTestGallery -Uri 'https://www.poshtestgallery.com/api/v2'
Get-PSResourceRepository -Name PoshTestGallery

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Örnek 2

Bu örnek, varsayılan PSGallery depoyu kaydeder. Önceki örnekten farklı olarak, depoyu kaydetmek PSGallery için Ad ve Uri parametrelerini kullanamıyoruz. PSGallery Depo varsayılan olarak kaydedilir ancak kaldırılabilir. Varsayılan kaydı geri yüklemek için bu komutu kullanın.

Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Örnek 3

Bu örnek aynı anda birden çok depo kaydeder. Bunu yapmak için Repository parametresini kullanır ve bir karma tablo dizisi sağlarız. Her karma tablo yalnızca NameParameterSet veya PSGalleryParameterSet parametreleriyle ilişkilendirilmiş anahtarlara sahip olabilir.

$arrayOfHashtables = @{
        Name = 'Local'
        Uri = 'D:/PSRepoLocal/'
        Trusted = $true
        Priority = 20
    },
    @{
        Name = 'PSGv3'
        Uri = 'https://www.powershellgallery.com/api/v3'
        Trusted = $true
        Priority = 50
    },
    @{
        PSGallery = $true
        Trusted = $true
        Priority = 10
    }
Register-PSResourceRepository -Repository $arrayOfHashtables
Get-PSResourceRepository

Name      Uri                                      Trusted Priority
----      ---                                      ------- --------
PSGallery https://www.powershellgallery.com/api/v2 True    10
Local     file:///D:/PSRepoLocal/                  True    20
PSGv3     https://www.powershellgallery.com/api/v3 True    50

Örnek 4

Bu örnek, kayıtlı bir SecretManagement kasasından alınacak kimlik bilgilerine sahip bir depo kaydeder. Microsoft.PowerShell.SecretManagement modülünün yüklü olması ve depolanan gizli diziyi içeren kayıtlı bir kasaya sahip olmanız gerekir. Gizli dizi biçiminin depo gereksinimleriyle eşleşmesi gerekir.

$parameters = @{
  Name = 'PSGv3'
  Uri = 'https://www.powershellgallery.com/api/v3'
  Trusted = $true
  Priority = 50
  CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Register-PSResourceRepository @parameters
Get-PSResourceRepository | Select-Object * -ExpandProperty CredentialInfo

Name           : PSGv3
Uri            : https://www.powershellgallery.com/api/v3
Trusted        : True
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Parametreler

-ApiVersion

Depo tarafından kullanılan API sürümünü belirtir. Geçerli değerler:

  • v2 - NuGet V2 API'sini kullanır
  • v3 - NuGet V3 API'sini kullanır
  • local - Bunu dosya sistemi tabanlı depolar için kullanın
  • nugetServer - NuGet.Server tabanlı depolar için bunu kullanın

Register-PSResourceRepository Cmdlet, API sürümünü otomatik olarak algılamalıdır. Bu parametre, depoyu kaydettikten sonra API sürümünü değiştirmenize olanak tanır.

Tür:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Kabul edilen değerler:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CredentialInfo

Bir kasanın adını ve Microsoft.PowerShell.SecretManagement deposunda depolanan gizli diziyi içeren bir PSCredentialInfo nesnesi.

Tür:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Zaten varsa bir deponun üzerine yazar.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Kaydedilecek deponun adı. Olamaz.PSGallery

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PassThru

Belirtildiğinde, başarıyla kaydedilen depoyu ve bilgilerini görüntüler.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Priority

Deponun öncelik derecelendirmesini belirtir. Geçerli öncelik değerleri 0 ile 100 arasında değişir. Düşük değerler daha yüksek öncelikli bir derecelendirmeye sahiptir. Varsayılan değer şudur: 50.

Depolar önceliğe ve sonra ada göre sıralanır. Birden çok depodaki kaynakları ararken PSResourceGet cmdlet'leri bu sıralama düzenini kullanarak depolarda arama yaparak bulunan ilk eşleşmeyi döndürür.

Tür:Int32
Position:Named
Default value:50
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PSGallery

Belirtildiğinde PSGallery deposunu kaydeder.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Repository

Depo bilgileri içeren bir karma tablo dizisi belirtir. Aynı anda birden çok depo kaydetmek için bu parametreyi kullanın. Her karma tablo yalnızca NameParameterSet veya PSGalleryParameterSet parametreleriyle ilişkilendirilmiş anahtarlara sahip olabilir.

Tür:Hashtable[]
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Trusted

Depoya güvenilip güvenilmeyeceğini belirtir.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Uri

Kaydedilecek deponun konumunu belirtir. Değerin aşağıdaki URI şemalarından birini kullanması gerekir:

  • https://
  • http://
  • ftp://
  • file://
Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Varsayılan olarak, cmdlet çıkış üretmez. PassThru parametresini kullandığınızda, cmdlet bir PSRepositoryInfo nesnesi döndürür.

Notlar

Depolar Ada göre benzersizdir. Aynı ada sahip bir depoyu kaydetme girişimi hatayla sonuçlanır.