Register-PSResourceRepository

Syntax

NameParameterSet (Standard)

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

PSGalleryParameterSet

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

MARParameterSet

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

RepositoriesParameterSet

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

Beschreibung

Beispiele

Beispiel 1

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

Beispiel 2

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

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

Beispiel 3

$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

Beispiel 4

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

Parameter

-ApiVersion

Gibt die API-Version an, die vom Repository verwendet wird. Gültige Werte sind:

• V2 – verwendet die NuGet V2-API
• V3 – verwendet die NuGet V3-API
• ContainerRegistry – wird für die Azure-Containerregistrierung verwendet
• Local – Verwenden Sie dies für dateisystembasierte Repositorys
• NugetServer – Verwenden Sie dies für NuGet.Server-basierte Repositorys

Das Cmdlet Register-PSResourceRepository sollte die API-Version automatisch erkennen. Mit diesem Parameter können Sie die API-Version ändern, nachdem Sie ein Repository registriert haben.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-CredentialInfo

Ein PSCredentialInfo--Objekt, das den Namen eines Tresors und einen geheimen Schlüssel enthält, der in einem Microsoft.PowerShell.SecretManagement Speicher gespeichert ist.

Parametereigenschaften

Parametersätze

-CredentialProvider

Dies ist ein dynamischer Parameter, der den Zugangsdatenanbieter für das Repository angibt. Dieser Parameter ist nur verfügbar, wenn das zu registrierende Repository ein Azure Artifacts-Feed ist. Gültige Werte sind:

• None - Kein Zugangsdatenanbieter definiert
• AzArtifacts - Verwenden Sie den Azure Artifacts Credential Provider

Wenn du diesen Parameter nicht verwendest, ist Noneder Standardwert . Wenn die URL des Repositorys oder enthält pkgs.dev.azure.compkgs.visualstudio.com, registriert der Befehl das Repository automatisch mit der Eigenschaft CredentialProvider, die auf AzArtifactsgesetzt ist.

Parametereigenschaften

Parametersätze

-Force

Überschreibt ein Repository, wenn es bereits vorhanden ist.

Parametereigenschaften

Parametersätze

-MicrosoftArtifactRegistry

Wenn angegeben, registriert er das Standard-Repository MicrosoftArtifactRegistry mit den folgenden Einstellungen:

• Name - MicrosoftArtifactRegistry
• Uri - https://mcr.microsoft.com/
• Trusted - Wahr
• Priority - 40
• ApiVersion - ContainerRegistry

Standardmäßig ist das MicrosoftArtifactRegistry Repository als Trusted Repository mit höherer Priorität als das Repository PSGallery registriert.

Du kannst diesen Parameter nicht verwenden, um das bestehende Repository zurückzusetzen. Nutze Set-PSResourceRepository es, um die Einstellungen des bestehenden Repositorys zu ändern.

Dieser Parameter wurde in Microsoft hinzugefügt. PowerShell.PSResourceGet v1.3.0-preview1.

Parametereigenschaften

Parametersätze

-Name

Name des zu registrierenden Repositorys. Kann nicht sein PSGallery oder MicrosoftArtifactRegistry.

Parametereigenschaften

Parametersätze

-PassThru

Wenn angegeben, werden das erfolgreich registrierte Repository und die zugehörigen Informationen angezeigt.

Parametereigenschaften

Parametersätze

-Priority

Gibt die Prioritätsrangfolge des Repositorys an. Gültige Prioritätswerte reichen von 0 bis 100. Niedrigere Werte weisen eine höhere Prioritätsrangfolge auf. Der Standardwert ist 50.

Repositorys werden nach Priorität und dann nach Namen sortiert. Beim Suchen nach Ressourcen über mehrere Repositorys hinweg durchsuchen die PSResourceGet--Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge und geben die erste gefundene Übereinstimmung zurück.

Parametereigenschaften

Parametersätze

-PSGallery

Wenn angegeben, registriert er das Standard-Repository PSGallery mit den folgenden Einstellungen:

• Name - PSGallery
• Uri - https://www.powershellgallery.com/api/v2
• Trusted - Falsch
• Priority - 50
• ApiVersion - V2

Standardmäßig wird das Repository PSGallery als Untrusted Repository mit niedrigerer Priorität als das Repository MicrosoftArtifactRegistry registriert.

Sie können dies nutzen, um die Standardregistrierung des Repositoriums PSGallery wiederherzustellen, falls diese entfernt wurde. Du kannst diesen Parameter nicht verwenden, um das bestehende Repository zurückzusetzen. Nutze Set-PSResourceRepository es, um die Einstellungen des bestehenden Repositorys zu ändern.

Parametereigenschaften

Parametersätze

-Repository

Gibt ein Array von Hashtables an, die Repositoryinformationen enthalten. Verwenden Sie diesen Parameter, um mehrere Repositorys gleichzeitig zu registrieren. Jede Hashtabelle kann nur Schlüsseln für parameter für das NameParameterSet- oder das PSGalleryParameterSet-zugeordnet sein.

Parametereigenschaften

Parametersätze

-Trusted

Gibt an, ob das Repository vertrauenswürdig sein soll.

Parametereigenschaften

Parametersätze

-Uri

Gibt den Speicherort des zu registrierenden Repositorys an. Der Wert muss eines der folgenden URI-Schemas verwenden:

• https://
• http://
• ftp://
• file://

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Hinweise

Ähnliche Themen

• Microsoft.PowerShell.SecretManagement
• Get-PSResourceRepository
• Set-PSResourceRepository
• Reset-PSResourceRepository
• Unregister-PSResourceRepository