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>]

Cmdleten registrerar en NuGet-lagringsplats som innehåller PowerShell-resurser.

I det här exemplet registreras lagringsplatsen med Namn för 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

I det här exemplet registreras standardlagringsplatsen PSGallery. Till skillnad från föregående exempel kan vi inte använda parametrarna Name och Uri för att registrera PSGallery-lagringsplatsen. Den PSGallery lagringsplatsen är registrerad som standard men kan tas bort. Använd det här kommandot för att återställa standardregistreringen.

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

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

I det här exemplet registreras flera lagringsplatser samtidigt. För att göra det använder vi parametern Repository och tillhandahåller en matris med hashtables. Varje hashtable kan bara ha nycklar associerade med parametrar för NameParameterSet eller 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

I det här exemplet registreras en lagringsplats med autentiseringsinformation som ska hämtas från ett registrerat SecretManagement-valv , där SecretStore är namnet på valvet och TestSecret är namnet på den lagrade hemligheten.

Du måste ha modulen Microsoft.PowerShell.SecretManagement installerad, ha ett registrerat valv och lagra en hemlighet i det. Om det är korrekt konfigurerat returnerar kommandot Get-SecretInfo -Name 'TestSecret' hemligheten.

Hemlighetens format måste matcha lagringsplatsens krav. I vissa fall kan du TestSecret behöva lagra som ett PSCredential-objekt med ett användarnamn och lösenord eller token. I andra fall kan den behöva lagras som en SecureString som bara representerar 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     :

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Som standard genererar cmdleten inga utdata. När du använder parametern PassThru returnerar cmdleten ett PSRepositoryInfo-objekt.

Lagringsplatser är unika med Namn. Försök att registrera en lagringsplats med samma namn resulterar i ett fel.