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

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 存放庫。 不同於上述範例，我們無法使用 Name 和 Uri 參數來註冊 PSGallery 存放庫。 PSGallery 存放庫預設會註冊，但可以移除。 使用此命令來還原默認註冊。

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

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

此範例會一次註冊多個存放庫。 若要這樣做，我們使用 Repository 參數，並提供哈希表陣列。 每個哈希表只能有與 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 物件。

存放庫 Name是唯一的。 嘗試以相同名稱註冊存放庫會導致錯誤。