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

该 cmdlet 注册包含 PowerShell 资源的 NuGet 存储库。

此示例使用 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

此示例注册默认 PSGallery 存储库。 与前面的示例不同，我们不能使用 名称 和 Uri 参数来注册 PSGallery 存储库。 默认情况下，PSGallery 存储库已注册，但可以删除。 使用此命令还原默认注册。

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

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

此示例一次注册多个存储库。 为此，我们使用 存储库 参数并提供哈希表数组。 每个哈希表只能有与 NameParameterSet 或 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

此示例使用要从已注册的 SecretManagement 文件库检索的凭证信息注册一个存储库，其中 SecretStore 是文件库的名称， TestSecret 是存储的密钥的名称。

您必须安装 Microsoft.PowerShell.SecretManagement 模块，注册文件库，并在其中存储密钥。 如果设置正确，该命令 Get-SecretInfo -Name 'TestSecret' 将返回密钥。

机密的格式必须与存储库的要求相匹配。 在某些情况下， TestSecret 可能需要存储为具有用户名和密码或令牌的 PSCredential 对象。 在其他情况下，它可能需要存储为仅表示令牌的 SecureString 。

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

默认情况下，cmdlet 不生成任何输出。 使用 PassThru 参数时，cmdlet 将返回 PSRepositoryInfo 对象。

存储库通过 名称是唯一的。 尝试使用同名注册存储库会导致错误。