Skip to content
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/Oracle/Oracle.Autorest/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ For information on how to develop for `Az.Oracle`, see [how-to.md](how-to.md).
> see https://aka.ms/autorest

```yaml
commit: d87c0a3d1abbd1d1aa1b487d99e77769b6895ef4
commit: 0a626b790148b419c9b0bbbc7f4db746d4d886e4
require:
- $(this-folder)/../../readme.azure.noprofile.md
- $(repo)/specification/oracle/resource-manager/readme.md
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "autonomousDatabases/autonomousDatabaseBackups",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "autonomousDatabases",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "cloudExadataInfrastructures/dbServers",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "cloudExadataInfrastructures",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "cloudVmClusters/dbNodes",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "cloudVmClusters",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "exadbVmClusters/dbNodes",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "exadbVmClusters",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "exascaleDbStorageVaults",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/autonomousDatabaseCharacterSets",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/autonomousDatabaseNationalCharacterSets",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/autonomousDbVersions",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/dbSystemShapes",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/dnsPrivateViews",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/dnsPrivateZones",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/flexComponents",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/giVersions/giMinorVersions",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "locations/giVersions",
"apiVersion": "2025-03-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.oracle"
},
Expand Down
4 changes: 2 additions & 2 deletions src/Oracle/Oracle.Autorest/custom/Az.Oracle.custom.psm1
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# region Generated
# Load the private module dll
$null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '..\bin\Az.Oracle.private.dll')
$null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '../bin/Az.Oracle.private.dll')

# Load the internal module
$internalModulePath = Join-Path $PSScriptRoot '..\internal\Az.Oracle.internal.psm1'
$internalModulePath = Join-Path $PSScriptRoot '../internal/Az.Oracle.internal.psm1'
if(Test-Path $internalModulePath) {
$null = Import-Module -Name $internalModulePath
}
Expand Down
8 changes: 4 additions & 4 deletions src/Oracle/Oracle.Autorest/custom/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Custom
This directory contains custom implementation for non-generated cmdlets for the `Az.Oracle` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `..\exports` folder. The only generated file into this folder is the `Az.Oracle.custom.psm1`. This file should not be modified.
This directory contains custom implementation for non-generated cmdlets for the `Az.Oracle` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `../exports` folder. The only generated file into this folder is the `Az.Oracle.custom.psm1`. This file should not be modified.

## Info
- Modifiable: yes
Expand All @@ -15,10 +15,10 @@ For C# cmdlets, they are compiled with the rest of the generated low-level cmdle
For script cmdlets, these are loaded via the `Az.Oracle.custom.psm1`. Then, during the build process, this module is loaded and processed in the same manner as the C# cmdlets. The fundamental difference is the script cmdlets use the `ParameterSetName` attribute and C# cmdlets do not. To create a script cmdlet variant of a generated cmdlet, simply decorate all parameters in the script with the new `ParameterSetName` in the `Parameter` attribute. This will appropriately treat each parameter set as a separate variant when processed to be exported during the build.

## Purpose
This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `..\exports` folder.
This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `../exports` folder.

## Usage
The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `..\exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `../exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
- Break
- DefaultProfile
- HttpPipelineAppend
Expand All @@ -36,6 +36,6 @@ For processing the cmdlets, we've created some additional attributes:
- `Microsoft.Azure.PowerShell.Cmdlets.Oracle.DoNotExportAttribute`
- Used in C# and script cmdlets to suppress creating an exported cmdlet at build-time. These cmdlets will *not be exposed* by `Az.Oracle`.
- `Microsoft.Azure.PowerShell.Cmdlets.Oracle.InternalExportAttribute`
- Used in C# cmdlets to route exported cmdlets to the `..\internal`, which are *not exposed* by `Az.Oracle`. For more information, see [README.md](..\internal/README.md) in the `..\internal` folder.
- Used in C# cmdlets to route exported cmdlets to the `../internal`, which are *not exposed* by `Az.Oracle`. For more information, see [README.md](../internal/README.md) in the `../internal` folder.
- `Microsoft.Azure.PowerShell.Cmdlets.Oracle.ProfileAttribute`
- Used in C# and script cmdlets to define which Azure profiles the cmdlet supports. This is only supported for Azure (`--azure`) modules.
44 changes: 43 additions & 1 deletion src/Oracle/Oracle.Autorest/docs/Az.Oracle.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
Module Name: Az.Oracle
Module Guid: 0cd4db40-5b77-4c36-a93f-881ee209ef62
Module Guid: ed192824-da85-4895-bc83-d1d357b29631
Download Help Link: https://learn.microsoft.com/powershell/module/az.oracle
Help Version: 1.0.0.0
Locale: en-US
Expand Down Expand Up @@ -41,9 +41,15 @@ Get a DbNode
### [Get-AzOracleDbServer](Get-AzOracleDbServer.md)
Get a DbServer

### [Get-AzOracleDbSystem](Get-AzOracleDbSystem.md)
Get a DbSystem

### [Get-AzOracleDbSystemShape](Get-AzOracleDbSystemShape.md)
Get a DbSystemShape

### [Get-AzOracleDbVersion](Get-AzOracleDbVersion.md)
Get a DbVersion

### [Get-AzOracleDnsPrivateView](Get-AzOracleDnsPrivateView.md)
Get a DnsPrivateView

Expand All @@ -68,6 +74,15 @@ Get a GiMinorVersion
### [Get-AzOracleGiVersion](Get-AzOracleGiVersion.md)
Get a GiVersion

### [Get-AzOracleNetworkAnchor](Get-AzOracleNetworkAnchor.md)
Get a NetworkAnchor

### [Get-AzOracleResourceAnchor](Get-AzOracleResourceAnchor.md)
Get a ResourceAnchor

### [Invoke-AzOracleActionAutonomousDatabase](Invoke-AzOracleActionAutonomousDatabase.md)
Perform Lifecycle Management Action on Autonomous Database

### [Invoke-AzOracleActionDbNode](Invoke-AzOracleActionDbNode.md)
VM actions on DbNode of VM Cluster by the provided filter

Expand All @@ -92,15 +107,24 @@ Create a CloudVmCluster
### [New-AzOracleCustomerContactObject](New-AzOracleCustomerContactObject.md)
Create an in-memory object for CustomerContact.

### [New-AzOracleDbSystem](New-AzOracleDbSystem.md)
Create a DbSystem

### [New-AzOracleExadbVMCluster](New-AzOracleExadbVMCluster.md)
Create a ExadbVmCluster

### [New-AzOracleExascaleDbStorageVault](New-AzOracleExascaleDbStorageVault.md)
Create a ExascaleDbStorageVault

### [New-AzOracleNetworkAnchor](New-AzOracleNetworkAnchor.md)
Create a NetworkAnchor

### [New-AzOracleNsgCidrObject](New-AzOracleNsgCidrObject.md)
Create an in-memory object for NsgCidr.

### [New-AzOracleResourceAnchor](New-AzOracleResourceAnchor.md)
Create a ResourceAnchor

### [Remove-AzOracleAutonomousDatabase](Remove-AzOracleAutonomousDatabase.md)
Delete a AutonomousDatabase

Expand All @@ -116,6 +140,9 @@ Delete a CloudVmCluster
### [Remove-AzOracleCloudVMClusterVM](Remove-AzOracleCloudVMClusterVM.md)
Remove VMs from the VM Cluster

### [Remove-AzOracleDbSystem](Remove-AzOracleDbSystem.md)
Delete a DbSystem

### [Remove-AzOracleExadbVMCluster](Remove-AzOracleExadbVMCluster.md)
Delete a ExadbVmCluster

Expand All @@ -125,6 +152,12 @@ Remove VMs from the VM Cluster
### [Remove-AzOracleExascaleDbStorageVault](Remove-AzOracleExascaleDbStorageVault.md)
Delete a ExascaleDbStorageVault

### [Remove-AzOracleNetworkAnchor](Remove-AzOracleNetworkAnchor.md)
Delete a NetworkAnchor

### [Remove-AzOracleResourceAnchor](Remove-AzOracleResourceAnchor.md)
Delete a ResourceAnchor

### [Rename-AzOracleAutonomousDatabaseDisasterRecoveryConfiguration](Rename-AzOracleAutonomousDatabaseDisasterRecoveryConfiguration.md)
Perform ChangeDisasterRecoveryConfiguration action on Autonomous Database

Expand All @@ -140,9 +173,18 @@ Update a CloudExadataInfrastructure
### [Update-AzOracleCloudVMCluster](Update-AzOracleCloudVMCluster.md)
Update a CloudVmCluster

### [Update-AzOracleDbSystem](Update-AzOracleDbSystem.md)
Update a DbSystem

### [Update-AzOracleExadbVMCluster](Update-AzOracleExadbVMCluster.md)
Update a ExadbVmCluster

### [Update-AzOracleExascaleDbStorageVault](Update-AzOracleExascaleDbStorageVault.md)
Update a ExascaleDbStorageVault

### [Update-AzOracleNetworkAnchor](Update-AzOracleNetworkAnchor.md)
Update a NetworkAnchor

### [Update-AzOracleResourceAnchor](Update-AzOracleResourceAnchor.md)
Update a ResourceAnchor

19 changes: 17 additions & 2 deletions src/Oracle/Oracle.Autorest/docs/Get-AzOracleDbSystemShape.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ Get a DbSystemShape

### List (Default)
```
Get-AzOracleDbSystemShape -Location <String> [-SubscriptionId <String[]>] [-Zone <String>]
[-DefaultProfile <PSObject>] [<CommonParameters>]
Get-AzOracleDbSystemShape -Location <String> [-SubscriptionId <String[]>] [-ShapeAttribute <String>]
[-Zone <String>] [-DefaultProfile <PSObject>] [<CommonParameters>]
```

### Get
Expand Down Expand Up @@ -159,6 +159,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -ShapeAttribute
Filters the result for the given Shape Attribute, such as BLOCK_STORAGE or SMART_STORAGE.

```yaml
Type: System.String
Parameter Sets: List
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SubscriptionId
The ID of the target subscription.
The value must be an UUID.
Expand Down
19 changes: 17 additions & 2 deletions src/Oracle/Oracle.Autorest/docs/Get-AzOracleGiVersion.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ Get a GiVersion

### List (Default)
```
Get-AzOracleGiVersion -Location <String> [-SubscriptionId <String[]>] [-Shape <String>] [-Zone <String>]
[-DefaultProfile <PSObject>] [<CommonParameters>]
Get-AzOracleGiVersion -Location <String> [-SubscriptionId <String[]>] [-Shape <String>]
[-ShapeAttribute <String>] [-Zone <String>] [-DefaultProfile <PSObject>] [<CommonParameters>]
```

### Get
Expand Down Expand Up @@ -148,6 +148,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -ShapeAttribute
Filters the result for the given Shape Attribute, such as BLOCK_STORAGE or SMART_STORAGE.

```yaml
Type: System.String
Parameter Sets: List
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SubscriptionId
The ID of the target subscription.
The value must be an UUID.
Expand Down
Loading
Loading