Erweiterte Konzepte

Die OCI-Module für PowerShell unterstützen die Verwendung von Umgebungsvariablen in einer PowerShell-Session zur Angabe von Werten für einige optionale allgemeine Parameter. Diese Umgebungsvariablen können direkt in der PowerShell-Session oder mit dem Cmdlet Set-OCIClientSession konfiguriert werden. Diesen Umgebungsvariablen zugewiesene Werte werden nur in der PowerShell-Session, in der sie festgelegt sind, für API-Aufrufe verwendet.

PS /> $Env:OCI_PS_REGION="us-phoenix-1"

PS /> Set-OCIClientSession -RegionId "us-ashburn-1" -Profile "Test" -Config "~/.oci/testconfig"
 
RegionId     Profile Config
--------     ------- ------
us-ashburn-1 Test    ~/.oci/testconfig

PS /> Get-OCIClientSession                                                                    
 
RegionId     Profile Config
--------     ------- ------
us-ashburn-1 Test

Beim Auswerten von Parametern befolgen die OCI-PowerShell-Module diese Prioritätsreihenfolge:

1. Der im Cmdlet-Parameter angegebene Wert.
2. Der in den Sessionvoreinstellungen angegebene Wert.
3. Der im vom Benutzer ausgewählten Profil der OCI-Konfigurationsdatei unter ~/.oci/config angegebene Wert.

Mit dem Historienspeicher können Sie:

Der Historienspeicher ist als Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStore-Objekt in einer PowerShell-Variable namens $OCICmdletHistory gekapselt.

Weitere Informationen finden Sie im Historienspeicherbeispiel auf GitHub.

OCI-Cmdlets, die Listen-API-Vorgänge aufrufen, können Ergebnisse paginieren, sodass Sie die verfügbaren Ergebnisse in Batches abrufen können (automatisch nach Paginierungstoken), bis keine weiteren Datensätze mehr verfügbar sind.

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId | Measure-Object
 
Count             : 100

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 5 | Measure-Object                                       
 
Count             : 5

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Page $OCICmdletHistory.LastResponse.OpcNextPage | Measure-Object
 
Count             : 100

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -All | Measure-Object                                            
 
Count             : 293

Die meisten Oracle Cloud Infrastructure-Ressourcen, wie z.B. Compute-Instanzen, haben Lebenszyklen. In vielen Fällen soll der Befehl warten, bis eine Ressource oder eine Arbeitsanforderung einen bestimmten Status erreicht oder ein Timeout überschritten wird, bevor weitere Aktionen ausgeführt werden. Sie können eine Ressource abfragen, um ihren Status zu bestimmen.

OCI-PowerShell-Module bieten Warteparameter, die es Ihrem Cmdlet ermöglichen, zu warten, bis eine Ressource einen gewünschten Status erreicht. Ein Cmdlet mit Warteparametern kann blockiert aufgerufen werden, was bedeutet, dass es wartet, bis ein gewünschter Status erreicht ist oder ein Timeout überschritten wird. Wartende abstrahieren die Polling-Logik, die Sie sonst hinzufügen müssten, bevor Sie weitere Aktionen für eine Ressource oder eine Arbeitsanforderung ausführen können.

Beispiel: Wenn Sie LaunchInstance im Compute-Service aufrufen, enthält der Antwortheader eine work-request-id. Die OCI-PowerShell-Module verwenden diese ID, wenn Sie den Parameter -WaitForStatus angeben. Dadurch wird Ihr Skript erst dann fortgesetzt, wenn die Arbeitsanforderung erfolgreich ist.

#Create a new compute instance and wait for the instance work request to succeed or fail, 
#polling every 60 seconds and attempting 20 times max
$ComputeInstance = New-OCIComputeInstance -LaunchInstanceDetails $LaunchDetails -WaitForStatus Succeeded,Failed -MaxWaitAttempts 20 -WaitIntervalSeconds 60

Dieses Beispiel auf GitHub zeigt, wie Sie mit Streams arbeiten können.

Um die Fehlerbehebung zu erleichtern, unterstützen OCI-PowerShell-Module neben Fehlermeldungen auch das Logging von Meldungen auf debug- und verbose-Ebene in der Konsole. Dieses Feature wurde in die PowerShell-Standardparameter Debug und Verbose integriert.

Übergeben Sie den Parameter -Debug oder -Verbose im Cmdlet-Aufruf, um Logmeldungen in der Konsole anzuzeigen.

Beispiel:

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 1 -Verbose
 
#More Verbose
PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 1 -Debug

Instanz-Principals ist ein IAM-Servicefeature, mit dem Instanzen zu autorisierten Akteuren (oder Principals) werden können, die Aktionen für Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden. Diese Zertifikate werden automatisch erstellt, Instanzen zugewiesen und rotiert, sodass Sie keine Zugangsdaten an die Hosts verteilen und sie rotieren müssen.

Um die Instanz-Principal-Authentifizierung aus OCI-Cmdlets zu aktivieren, autorisieren Sie die Instanz, Aufrufe auszuführen, und legen Sie den AuthType-Parameter fest. Beispiel:

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Realm-spezifische Endpunktvorlagen auf Anwendungsebene aktivieren:

Realm-spezifische Endpunktvorlagen auf Clientebene aktivieren:

$NamespaceName = Get-OCIObjectStorageNamespace -CompartmentId $CompartmentId -UseRealmSpecificEndpoint -Debug

Ein vollständiges Beispiel finden Sie im Beispiel CreateBucketUsingRealmSpecificEndpoint_ObjectStorage auf GitHub.