Data ONTAP® PowerShell Toolkit

Switch to clustered Data ONTAP documentation.

Cmdlet: Remove-NaAggr


NAME
Remove-NaAggr

SYNOPSIS
Destroys the specified aggregate or plex.

SYNTAX
Remove-NaAggr [-Name] <String> [-Force] [-Controller <NaController>] [<Commo
nParameters>]


DESCRIPTION
Destroys the specified aggregate or plex. If an aggregate is specified, all
plexes in the aggregate are destroyed. If the aggregate is embedded in a t
raditional volume, then the entire traditional volume is destroyed. Otherwi
se, the operation will be rejected if there are one or more flexible volumes
in the aggregate - they must be destroyed beforehand. If a plex is specifie
d, only that plex is destroyed, leaving an unmirrored aggregate containing t
he remaining plex. The disks in the destroyed object become spare disks. O
nly offline aggregates and plexes can be destroyed.


PARAMETERS
-Name <String>
Name of the existing aggregate or plex to be destroyed, using the follow
ing format:

[/vol/]<aggrname>[<plexinfo>]

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Force
When using Remove-NaAggr on a traditional volume, force the destruction
of the volume even if a non-default vfiler has storage on it. Normally,
the system will not destroy such a volume and will instead return EVOLU
ME_HAS_VFILER_STORAGE.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS



NOTES


Category: aggr
API: aggr-destroy

-------------- Set offline and destroy --------------

C:\PS>Set-NaAggr aggr1 -Offline | Remove-NaAggr


Destroy aggregate 'aggr1' after setting it offline.






RELATED LINKS
Set-NaAggr
Get-NaAggr







 Data ONTAP® PowerShell Toolkit