Freigeben über


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 cmdlet Set-PSResourceRepository legt Informationen für ein registriertes Repository fest.

Beispiele

Beispiel 1

In diesem Beispiel wurde der URI- für das PoshTestGallery Repository registriert. Das cmdlet Set-PSResourceRepository 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.

Anmerkung

Der URI- Wert des Standard-PSGallery- Repositorys 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 parameter Repository verwendet, um Werte für mehrere Repositorys zu ändern. Der Parameter verwendet ein Array von Hashtables. Jede Hashtabelle enthält Informationen, die das Repository aktualisiert wird.

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 Vault abgerufen werden sollen. Sie müssen über die Microsoft.PowerShell.SecretManagement Modulinstallation verfügen und über einen registrierten Tresor verfügen, der den gespeicherten geheimen Schlüssel enthält. Das Format des geheimen Schlüssels 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
  • 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.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Zulässige Werte:V2, V3, Local, NugetServer, ContainerRegistry
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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 einen geheimen Schlüssel enthält, der 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.

Anmerkung

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

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

-PassThru

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

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

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

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

-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 die NameParameterSet-zugeordnet sein.

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 passiert, 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.