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