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ı PoshTestGallery
ile 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ırv3
- NuGet V3 API'sini kullanırlocal
- Bunu dosya sistemi tabanlı depolar için kullanınnugetServer
- 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.
İlişkili Bağlantılar
PSResourceGet