Register-PSResourceRepository

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

Register-PSResourceRepository
    [-PSGallery]
    [-Trusted]
    [-Priority <Int32>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Register-PSResourceRepository
    -Repository <Hashtable[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

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

Cet exemple enregistre le référentiel PSGallery par défaut. Contrairement à l’exemple précédent, nous ne pouvons pas utiliser les paramètres name et Uri pour inscrire le référentiel . Le dépôt PSGallery 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

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 le NameParameterSet ou le 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

Cet exemple enregistre un référentiel avec des informations d’identification à extraire d’un coffre-fort SecretManagement enregistré, où SecretStore est le nom du coffre-fort et TestSecret est le nom du secret stocké.

Le module Microsoft.PowerShell.SecretManagement doit être installé, disposer d’un coffre-fort enregistré et d’un secret stocké dans celui-ci. Si elle est correctement configurée, la commande Get-SecretInfo -Name 'TestSecret' renvoie le secret.

Le format du secret doit correspondre aux exigences du référentiel. Dans certains cas, TestSecret il peut être nécessaire de le stocker en tant qu’objet PSCredential avec un nom d’utilisateur et un mot de passe ou un jeton. Dans d’autres, il peut être nécessaire de le stocker en tant que SecureString représentant uniquement le jeton.

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

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.

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.