< Back

Remove-AzureVMExtension

Wed Jan 30, 2019 5:51 pm

NAME Remove-AzureVMExtension



SYNOPSIS

Removes resource extensions from a virtual machine.





SYNTAX

Remove-AzureVMExtension [-ExtensionName] <String> [-Publisher] <String> -VM <IPersistentVM> [-Profile <AzureSMProfile>] [-InformationAction

<ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]



Remove-AzureVMExtension [-ReferenceName] <String> -VM <IPersistentVM> [-Profile <AzureSMProfile>] [-InformationAction <ActionPreference>]

[-InformationVariable <String>] [<CommonParameters>]



Remove-AzureVMExtension [-RemoveAll] -VM <IPersistentVM> [-Profile <AzureSMProfile>] [-InformationAction <ActionPreference>] [-InformationVariable

<String>] [<CommonParameters>]





DESCRIPTION

The Remove-AzureVMExtension cmdlet removes resource extensions from a virtual machine.





PARAMETERS

-ExtensionName <String>

Specifies the extension name that this cmdlet removes.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Publisher <String>

Specifies the extension publisher.



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VM <IPersistentVM>

Specifies the persistent virtual machine object.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue, ByPropertyName)

Accept wildcard characters? false



-Profile <AzureSMProfile>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ReferenceName <String>

Specifies the reference name of the extension.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-RemoveAll [<SwitchParameter>]

Indicates that this cmdlet removes all resource extensions from the virtual machine.



Required? true

Position? 1

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- Example 1: Remove an extension using a specific name and publisher --------------------------



PS C:\\>$VM = Remove-AzureVMExtension -VM $VM -ExtensionName $EXT -Publisher $PUB;



This command removes an extension with the specified name and publisher.

-------------------------- Example 2: Remove all extensions from a specific virtual machine --------------------------



PS C:\\>$VM = Remove-AzureVMExtension -VM $VM -RemoveAll;



This command removes all extensions from the specified virtual machine as stored in the variable $VM.



RELATED LINKS

Get-AzureVMExtension

Set-AzureVMExtension

Azure Service Cmdlets