Remove-AzureServiceExtension

Module:
Azure
Removes cloud service extensions that are applied on a deployment.

Syntax

Remove-AzureServiceExtension
      [[-ServiceName] <String>]
      [[-Slot] <String>]
      [[-Role] <String[]>]
      [-ExtensionName] <String>
      [-ProviderNamespace] <String>
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureServiceExtension
      [[-ServiceName] <String>]
      [[-Slot] <String>]
      [-ExtensionName] <String>
      [-ProviderNamespace] <String>
      [-UninstallConfiguration]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

The Remove-AzureServiceExtension cmdlet removes cloud service extensions that are applied on a deployment.

Examples

Example 1: Remove a service extension

PS C:\> Remove-AzureServiceExtension -ServiceName $Svc -Slot "Production" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions"

This command removes a service extension.

Example 2: Remove a service extension and uninstall all configurations

PS C:\> Remove-AzureServiceExtension -ServiceName $Svc -Slot "Production" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -UninstallConfiguration

This command removes a service extension and uninstalls all configurations.

Required Parameters

-ExtensionName

Specifies the extension name.

Type:String
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ProviderNamespace

Specifies the extension provider namespace.

Type:String
Position:4
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-UninstallConfiguration

Indicates that this cmdlet uninstalls all configurations from the cloud service.

Type:SwitchParameter
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-InformationAction

Specifies how this cmdlet responds to an information event.

The acceptable values for this parameter are:

  • Continue
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InformationVariable

Specifies an information variable.

Type:String
Aliases:iv
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Type:AzureSMProfile
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Role

Specifies an optional array of roles to specify the extension for. If not specified the extension is applied as the default configuration for all roles.

Type:String[]
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ServiceName

Specifies the cloud service name.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Slot

Specifies the environment of the deployment to modify. Valid values are Production or Staging.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False