NetAppDocs PowerShell Module

Get-NtapFilerAsupData


NAME
    Get-NtapFilerAsupData

SYNOPSIS
    Collects data for Data ONTAP 7-Mode storage systems using ASUPs.


SYNTAX
    Get-NtapFilerAsupData [-System] <String[]> [-AsupSubject <String>] [-Force] [<CommonParameters>]

    Get-NtapFilerAsupData [-AsupId] <String[]> [-Force] [<CommonParameters>]

    Get-NtapFilerAsupData [-AsupObject] <XmlElement[]> [-Force] [<CommonParameters>]


DESCRIPTION
    Uses the controller ASUP to gather as much configuration information as possible. This
    data can be used to automate build docs and health checks. It can also be used for historical
    configuration information. If the -System parameter is used, the latest ASUP of the specified
    AsupSubject type will be used. If an older or specific ASUP is desired, use the
    Find-NtapFilerAsup function and pass those results to this function. The ASUPs will be validated
    to determine that an ASUP from each node is present, complete and generated at similar times.


PARAMETERS
    -System <String[]>
        The system information to search for (e.g., HA pair: 'Node1Hostname:Node1SerialNumber!Node2Hostname:Node2SerialNumber'
        and stand-alone: 'NodeName:NodeSerialNumber').

        Required?                    true
        Position?                    1
        Default value
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -AsupId <String[]>
        The ASUPID(s) to search for. An ASUPID from each node in the HA pair is required. Each node's ASUPID must be
        separated by an exclamation point (e.g., 2015012500120554!2015012423440127). Sets of ASUPIDs from multiple
        HA pairs must be comma separated (e.g., 2015012500120554!2015012423440127, 2015062302150043!2015062302150041).

        Required?                    true
        Position?                    1
        Default value
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -AsupObject <XmlElement[]>
        An ASUP object passed from the Find-NtapFilerAsup function.

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

    -AsupSubject <String>
        The type of ASUP to query for (weekly or user_triggered).

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

    -Force [<SwitchParameter>]
        Forces the use of a invalid ASUP (i.e., ASUP content missing or mismatched generated dates between
        the nodes in the HA pair).

        Required?                    false
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        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
    System.Xml.XmlElement


OUTPUTS
    System.Management.Automation.PSCustomObject


NOTES


        AUTHOR : Jason Cole
        REQUIRES : Internal connection to NetApp

    -------------------------- EXAMPLE 1 --------------------------

    PS>Get-NtapFilerAsupData -System 'mtharvard:30020945!mtmassive:30020946' | Export-Clixml -Path
    'D:\mtharvard-mtmassive_Asup_raw.xml'

    Collects the controller information from the HA pair information specified and saves the results
    to a .xml file for further processing.




    -------------------------- EXAMPLE 2 --------------------------

    PS>Get-NtapFilerAsupData -System 'mtharvard:30020945!mtmassive:30020946' -AsupSubject user_triggered | Export-Clixml -Path
    'D:\mtharvard-mtmassive_Asup_raw.xml'

    Collects the controller information from the HA pair information specified, using the latest user_triggered
    ASUP set, and saves the results to a .xml file for further processing.




    -------------------------- EXAMPLE 3 --------------------------

    PS>Get-NtapFilerAsupData -System 'mtharvard:30020945!mtmassive:30020946' | Format-NtapFilerData | Out-NtapDocument -WordFile
    'D:\Output\mtharvard-mtmassive_Asup.docx' -ExcelFile 'D:\Output\mtharvard-mtmassive_Asup.xlsx'

    Collects the controller information from the system information specified, formats the data and creates
    the specified Word and Excel documents.




    -------------------------- EXAMPLE 4 --------------------------

    PS>Get-NtapFilerAsupData -AsupId 2015011716380597!2015011716330550 | Export-Clixml -Path
    'D:\Output\mtmassive_mtharvard-Asup_raw.xml'

    Perform the data collection using specific ASUPIDs.




    -------------------------- EXAMPLE 5 --------------------------

    PS>Get-NtapFilerAsupData -System 'mtmassive:30020946' -Force | Export-Clixml -Path 'D:\mtmassive_Asup_raw.xml'

    Collects the controller information from the system name and serial number specified and saves the
    results to a .xml file for further processing. If this node is a member of an HA pair and, for some
    reason, you do not want the data from the other node the -Force parameter must be specified (Note: in
    almost all cases this will result in incomplete data).




    -------------------------- EXAMPLE 6 --------------------------

    PS>Find-NtapFilerAsup -System 'mtharvard:30020945!mtmassive:30020946' -StartDate 10-15-2014 -EndDate 11-15-2014 |
    Get-NtapFilerAsupData | Export-Clixml -Path 'D:\Output\mtmassive_mtharvard-Asup_raw.xml'

    Finds the first validated weekly ASUP set for the specified HA pair by searching between the dates
    specified, performs the data collection and saves the results to a .xml file for further processing.





RELATED LINKS
    https://community.netapp.com/t5/NetAppDocs/bd-p/netappdocs
    Format-NtapFilerData