Register-PSResourceRepository

Syntaxe

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

L’applet de commande inscrit un référentiel NuGet contenant des ressources PowerShell.

Exemples

Exemple 1

Cet exemple enregistre le référentiel avec le nom de 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

Exemple 2

Cet exemple enregistre le référentiel par défaut PSGallery . Contrairement à l’exemple précédent, nous ne pouvons pas utiliser les paramètres Name et Uri pour inscrire le PSGallery référentiel. Le PSGallery référentiel est inscrit par défaut, mais peut être supprimé. Utilisez cette commande pour restaurer l’inscription par défaut.

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

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

Exemple 3

Cet exemple enregistre plusieurs référentiels à la fois. Pour ce faire, nous utilisons le paramètre Référentiel et fournissons un tableau de tables de hachage. Chaque table de hachage ne peut avoir que des clés associées à des paramètres pour NameParameterSet ou PSGalleryParameterSet.

$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

Exemple 4

Cet exemple enregistre un référentiel avec des informations d’identification à récupérer à partir d’un coffre SecretManagement inscrit. Le module Microsoft.PowerShell.SecretManagement doit être installé et disposer d’un coffre inscrit contenant le secret stocké. Le format du secret doit correspondre aux exigences du référentiel.

$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ètres

-ApiVersion

-Confirm

-CredentialInfo

-Force

-Name

-PassThru

-Priority

-PSGallery

-Repository

-Trusted

-Uri

-WhatIf

Entrées

None

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Par défaut, l’applet de commande ne produit aucune sortie. Lorsque vous utilisez le paramètre PassThru , l’applet de commande retourne un objet PSRepositoryInfo .

Notes

Les référentiels sont uniques par nom. La tentative d’inscription d’un référentiel portant le même nom entraîne une erreur.

Liens associés

• Microsoft.PowerShell.SecretManagement