Register-PSResourceRepository

Register-PSResourceRepository
    [-Name] <string>
    [-Uri] <string>
    [-Trusted]
    [-Priority <int>]
    [-ApiVersion <PSRepositoryInfo+APIVersion>]
    [-CredentialInfo <PSCredentialInfo>]
    [-CredentialProvider <CredentialProvider>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

Register-PSResourceRepository
    -MicrosoftArtifactRegistry
    [-Trusted]
    [-Priority <int>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

Il cmdlet registra un repository NuGet contenente le risorse di PowerShell.

In questo esempio viene registrato il repository con il nome di 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

In questo esempio viene registrato il repository di PSGallery predefinito. A differenza dell'esempio precedente, non è possibile usare i parametri name e Uri per registrare il repository di . Il repository PSGallery è registrato per impostazione predefinita, ma può essere rimosso. Usare questo comando per ripristinare la registrazione predefinita.

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

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

In questo esempio vengono registrati più repository contemporaneamente. A tale scopo, viene usato il parametro repository e viene fornita una matrice di tabelle hash. Ogni tabella hash può avere chiavi associate solo ai parametri per il NameParameterSet o la 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

In questo esempio viene registrato un repository con le informazioni sulle credenziali da recuperare da un insieme di credenziali SecretManagement registrato, dove SecretStore è il nome dell'insieme di credenziali e TestSecret è il nome del segreto archiviato.

È necessario che il modulo Microsoft.PowerShell.SecretManagement sia installato, che si disponga di un insieme di credenziali registrato e che sia stato archiviato un segreto al suo interno. Se configurato correttamente, il comando Get-SecretInfo -Name 'TestSecret' restituirà il segreto.

Il formato del segreto deve corrispondere ai requisiti del repository. In alcuni casi, TestSecret potrebbe essere necessario archiviarlo come oggetto PSCredential con un nome utente e una password o un token. In altri potrebbe essere necessario archiviarlo come SecureString che rappresenta solo il token.

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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Per impostazione predefinita, il cmdlet non produce alcun output. Quando si usa il parametro PassThru , il cmdlet restituisce un oggetto PSRepositoryInfo.

I repository sono univoci in base al nome . Il tentativo di registrare un repository con lo stesso nome genera un errore.