Share via

Register-PSResourceRepository

  • Referencia
Modul:
Microsoft.PowerShell.PSResourceGet

A PowerShell-erőforrások adattárát regisztrálja.

Syntax

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

A parancsmag regisztrál egy PowerShell-erőforrásokat tartalmazó NuGet-adattárat.

Példák

1. példa

Ez a példa az adattárat a névvel regisztrálja PoshTestGallery.

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

2. példa

Ez a példa az alapértelmezett PSGallery adattárat regisztrálja. Az előző példától eltérően nem használhatjuk a Név és az Uri paramétereket az PSGallery adattár regisztrálásához. Az PSGallery adattár alapértelmezés szerint regisztrálva van, de eltávolítható. Ezzel a paranccsal visszaállíthatja az alapértelmezett regisztrációt.

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

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

3. példa

Ez a példa egyszerre több adattárat regisztrál. Ehhez az Adattár paramétert használjuk, és kivonatolótömböt adunk meg. Minden kivonatoló csak a NameParameterSet vagy a PSGalleryParameterSet paraméteréhez társított kulcsokkal rendelkezhet.

$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

4. példa

Ez a példa regisztrál egy adattárat a regisztrált SecretManagement-tárolóból lekérendő hitelesítő adatokkal. Telepítve kell lennie a Microsoft.PowerShell.SecretManagement modulnak, és rendelkeznie kell egy regisztrált tárolóval, amely tartalmazza a tárolt titkos kódot. A titkos kód formátumának meg kell felelnie az adattár követelményeinek.

$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     :

Paraméterek

-ApiVersion

Az adattár által használt API-verziót adja meg. Az érvényes értékek a következők:

  • v2 - a NuGet V2 API-t használja
  • v3 - a NuGet V3 API-t használja
  • local - ezt fájlrendszeralapú adattárakhoz használhatja
  • nugetServer - használja ezt a NuGet.Server-alapú adattárakhoz

A Register-PSResourceRepository parancsmagnak automatikusan észlelnie kell az API-verziót. Ez a paraméter lehetővé teszi az API-verzió módosítását egy adattár regisztrálása után.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Accepted values:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-CredentialInfo

PSCredentialInfo objektum, amely tartalmazza a tároló nevét és a Microsoft.PowerShell.SecretManagement tárolóban tárolt titkos kulcsokat.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Felülír egy adattárat, ha már létezik.

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

-Name

A regisztrálandó adattár neve. Nem lehet PSGallery.

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

-PassThru

Ha meg van adva, megjeleníti a sikeresen regisztrált adattárat és annak adatait.

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

-Priority

Megadja az adattár prioritási rangsorát. Az érvényes prioritási értékek 0 és 100 között mozognak. Az alacsonyabb értékek magasabb prioritású rangsorolással rendelkeznek. Az alapértelmezett érték 50.

Az adattárak prioritás, majd név szerint vannak rendezve. Ha több adattárban keres erőforrásokat, a PSResourceGet parancsmagok ezzel a rendezési sorrendben keresik az adattárakat, és visszaadják az első találatot.

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

-PSGallery

Ha meg van adva, regisztrálja a PSGallery-adattárat .

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

-Repository

Adattáradatokat tartalmazó kivonatolótömböt ad meg. Ezzel a paraméterel egyszerre több adattárat is regisztrálhat. Minden kivonatoló csak a NameParameterSet vagy a PSGalleryParameterSet paraméteréhez társított kulcsokkal rendelkezhet.

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

-Trusted

Megadja, hogy az adattárnak megbízhatónak kell-e lennie.

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

-Uri

Megadja a regisztrálandó adattár helyét. Az értéknek az alábbi URI-sémák egyikét kell használnia:

  • https://
  • http://
  • ftp://
  • file://
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

None

Kimenetek

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Alapértelmezés szerint a parancsmag nem hoz létre kimenetet. A PassThru paraméter használatakor a parancsmag egy PSRepositoryInfo objektumot ad vissza.

Jegyzetek

Az adattárak név szerint egyediek. Ha ugyanazzal a névvel próbál regisztrálni egy adattárat, az hibát eredményez.