Set-PSResourceRepository

Legt Informationen für ein registriertes Repository fest.

Syntax

Set-PSResourceRepository
   [-Name] <String>
   [-Uri <String>]
   [-Trusted]
   [-Priority <Int32>]
   [-ApiVersion <APIVersion>]
   [-CredentialInfo <PSCredentialInfo>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSResourceRepository
   -Repository <Hashtable[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Set-PSResourceRepository Cmdlet legt Informationen für ein registriertes Repository fest.

Beispiele

Beispiel 1

In diesem Beispiel wurde der URI für das Repository PoshTestGallery registriert. Das Set-PSResourceRepository Cmdlet wird verwendet, um den URI in einen lokalen Pfad zu ändern. Mit dem PassThru-Parameter können Sie das geänderte Repository anzeigen.

Get-PSResourceRepository -Name "PoshTestGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Set-PSResourceRepository -Name "PoshTestGallery" -Uri "c:/code/testdir" -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  file:///c:/code/testdir                        False         50

Beispiel 2

In diesem Beispiel werden die Werte Priority und Trusted des Repositorys geändert.

Hinweis

Der URI-Wert des PSGallery-Standardrepositorys kann nicht geändert werden.

Get-PSResourceRepository -Name "PSGallery"

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

Set-PSResourceRepository -Name "PSGallery" -Priority 25 -Trusted -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         25

Beispiel 3

In diesem Beispiel wird der Repository-Parameter verwendet, um Werte für mehrere Repositorys zu ändern. Der Parameter akzeptiert ein Array von Hashtabellen. Jede Hashtabelle enthält Informationen, die das Zu aktualisierende Repository enthält.

Get-PSResourceRepository

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

$arrayOfHashtables = @{Name = "PSGallery"; Trusted = $True},
                     @{Name = "PoshTestGallery"; Uri = "c:/code/testdir"}
Set-PSResourceRepository -Repository $arrayOfHashtables -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         50
PoshTestGallery  file:///c:/code/testdir                        False         50

Beispiel 4

In diesem Beispiel wird ein Repository mit Anmeldeinformationen aktualisiert, die aus einem registrierten Microsoft.PowerShell.SecretManagement-Tresor abgerufen werden sollen. Sie müssen das Modul Microsoft.PowerShell.SecretManagement installieren und über einen registrierten Tresor verfügen, der das gespeicherte Geheimnis enthält. Das Format des Geheimnisses muss den Anforderungen des Repositorys entsprechen.

$parameters = @{
  Name = "PoshTestGallery"
  Uri = "c:/code/testdir"
  CredentialInfo = [Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Set-PSResourceRepository @parameters -PassThru |
    Select-Object * -ExpandProperty CredentialInfo

Name           : PoshTestGallery
Uri            : file:///c:/code/testdir
Trusted        : False
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PowerShellGet.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.
  • local – Verwenden Sie dies für dateisystembasierte Repositorys.
  • nugetServer – Verwenden Sie dies für NuGet.Server-basierte Repositorys.

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

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Zulässige Werte:unknown, v2, v3, local, nugetServer
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CredentialInfo

Ein PSCredentialInfo-Objekt , das den Namen eines Tresors und ein Geheimnis enthält, das in einem Microsoft.PowerShell.SecretManagement-Speicher gespeichert ist.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu ändernden Repositorys an.

Hinweis

Der URI-Wert des PSGallery-Standardrepositorys kann nicht geändert werden.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Wenn angegeben, zeigt das erfolgreich registrierte Repository und die zugehörigen Informationen an.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Priority

Gibt die Rangfolge der Priorität des Repositorys an. Gültige Prioritätswerte liegen zwischen 0 und 100. Niedrigere Werte weisen eine höhere Priorität auf. Standardwert: 50.

Repositorys werden nach Priorität und dann nach Name sortiert. Bei der Suche nach Ressourcen in mehreren Repositorys durchsuchen die PSResourceGet-Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge und geben die erste gefundene Übereinstimmung zurück.

Typ:Int32
Position:Named
Standardwert:50
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Repository

Gibt ein Array von Hashtabellen an, die Repositoryinformationen enthalten. Verwenden Sie diesen Parameter, um mehrere Repositorys gleichzeitig zu registrieren. Jede Hashtabelle kann nur Schlüssel enthalten, die Parametern für das NameParameterSet zugeordnet sind.

Typ:Hashtable[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Trusted

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

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Uri

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

  • https://
  • http://
  • ftp://
  • file://
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Standardmäßig erzeugt das Cmdlet keine Ausgabe. Wenn Sie den PassThru-Parameter verwenden, gibt das Cmdlet ein PSRepositoryInfo-Objekt zurück.