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