Skip to main content
Version: v0.6.0

Azure Management

This module provides the following capabilities:

Installation

To have access to the following features, you have to import the module:

PS> Install-Module -Name Arcus.Scripting.Management

Removing a soft deleted API Management instance

Removes a soft deleted API Management instance. For more information on API Management and soft deletion see here.

ParameterMandatoryDescription
NameyesThe name of the API Management instance that has been soft deleted.
SubscriptionIdnoThe Id of the subscription containing the Azure API Management instance.
When not provided, it will be retrieved from the current context (Get-AzContext).
EnvironmentNamenoThe name of the Azure environment where the Azure API Management instance resides. (default: AzureCloud)
AccessTokennoThe access token to be used to remove the Azure API Management instance.
When not provided, it will be retrieved from the current context (Get-AzContext).
ApiVersion noThe version of the management API to be used. (default: 2021-08-01)

💡 The ApiVersion has successfully been tested with version 2021-08-01.

Example

PS> Remove-AzApiManagementSoftDeletedService -Name "my-apim"
# Checking if the API Management instance with name 'my-apim' is listed as a soft deleted service
# API Management instance has been found for name 'my-apim' as a soft deleted service
# Removing the soft deleted API Management instance 'my-apim'
# Successfully removed the soft deleted API Management instance 'my-apim'

Restoring a soft deleted API Management instance

Restores a soft deleted API Management instance. For more information on API Management and soft deletion see here.

ParameterMandatoryDescription
NameyesThe name of the API Management instance that has been soft deleted.
SubscriptionIdnoThe Id of the subscription containing the Azure API Management instance.
When not provided, it will be retrieved from the current context (Get-AzContext).
EnvironmentNamenoThe name of the Azure environment where the Azure API Management instance resides. (default: AzureCloud)
AccessTokennoThe access token to be used to restore the Azure API Management instance.
When not provided, it will be retrieved from the current context (Get-AzContext).
ApiVersion noThe version of the management API to be used. (default: 2021-08-01)

💡 The ApiVersion has successfully been tested with version 2021-08-01.

Example

PS> Restore-AzApiManagementSoftDeletedService -Name "my-apim"
# Checking if the API Management instance with name 'my-apim' is listed as a soft deleted service
# API Management instance has been found for name 'my-apim' as a soft deleted service
# Restoring the soft deleted API Management instance 'my-apim'
# Successfully restored the soft deleted API Management instance 'my-apim'