Overview  Categories  Cmdlets  APIs  Release notes  License

Data ONTAP® PowerShell Toolkit

Cmdlet: Split-NaAggrMirror

NAME
    Split-NaAggrMirror
    
SYNOPSIS
    Remove the specified plex from a mirrored aggregate and create a new unmirro
    red aggregate with the specified name that contains the plex.
    
SYNTAX
    Split-NaAggrMirror [-Name] <String> [-NewName] <String> [-Controller <NaCont
    roller>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-W
    hatIf] [-Confirm] [<CommonParameters>]
    
    
DESCRIPTION
    Remove the specified plex from a mirrored aggregate and create a new unmirro
    red aggregate with the specified name that contains the plex.  The original 
    mirrored aggregate thus becomes unmirrored.  The plex to be split from the o
    riginal aggregate must be functional (not partial), but it can otherwise be 
    inactive, resyncing, or out-of-date.  "Split-NaAggrMirror" can therefore be 
    used to gain access to a plex that isn't up to date with respect to its part
    ner plex if its partner plex is currently failed.  If the plex is offline at
     the time of the split, the resulting aggregate will be offline.  Otherwise,
     the resulting aggregate will be in the same online/offline/restricted state
     as the original aggregate.  A split mirror can be joined back together via 
    the "VictimAggregate" option to "New-NaAggrMirror".
    

PARAMETERS
    -Name <String>
        Name of the plex to split out of its aggregate, using the following form
        at: 
        
        [/vol/]<aggrname>[<plexinfo>][<groupinfo>]
        
        Required?                    true
        Position?                    1
        Default value                
        Accept pipeline input?       true (ByValue)
        Accept wildcard characters?  false
        
    -NewName <String>
        Name of the new aggregate to create from the split plex.
        
        Required?                    true
        Position?                    2
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -Controller <NaController>
        The DataONTAP controller object, embodied by an NaController object.  Th
        is parameter is returned by the Connect-NaController cmdlet.  If not spe
        cified, the value in the global variable CurrentNaController is used.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WarningAction <ActionPreference>
        
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WarningVariable <String>
        
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WhatIf
        
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -Confirm
        
        
        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
    NetApp.Ontapi.Filer.Aggr.AggrInfo
     
    
NOTES
    
    
        Category: aggr
        API: aggr-split
    
    --------------  Example 1 --------------
    
    C:\PS>
    
    
    
    
    
    
    
    
    
RELATED LINKS

Copyright © 2010 NetApp.  All rights reserved.  Use is subject to license terms.

Data ONTAP® PowerShell Toolkit