NetAppDocs PowerShell Module

Find-NtapFilerAsup


NAME
    Find-NtapFilerAsup

SYNOPSIS
    Finds a specific ASUP set for a Data ONTAP 7-Mode storage system.


SYNTAX
    Find-NtapFilerAsup -System <Object> [-AsupSubject <String>] [-Start <Int32>] [-Limit <Int32>] [-Oldest] [-ListOnly]
    [<CommonParameters>]

    Find-NtapFilerAsup -System <Object> [-AsupSubject <String>] -Last <Int32> [-Start <Int32>] [-Limit <Int32>] [-Oldest]
    [-ListOnly] [<CommonParameters>]

    Find-NtapFilerAsup -System <Object> [-AsupSubject <String>] -StartDate <String> [-EndDate <String>] [-Start <Int32>] [-Limit
    <Int32>] [-Oldest] [-ListOnly] [<CommonParameters>]

    Find-NtapFilerAsup -AsupId <String> [-ListOnly] [<CommonParameters>]


DESCRIPTION
    Queries the ASUP database to find specific ASUPIDs for NetApp 7DOT storage systems. This is useful
    when a set of ASUPs other than the latest set is necessary. By default, this will return the first
    validated set of ASUPs that can be passed to the Get-NtapFilerAsupData function. The -ListOnly
    parameter will return all ASUPs found but the output cannot be passed to the Get-NtapFilerAsupData
    function (to prevent including the same data from multiple ASUPs in the output).

    ASUP Validation: The ASUP set(s) returned will be validated to ensure the data is complete, that an ASUP
    from each node in the HA pair is present and that each ASUP in the set was generated within an hour
    of each other in the set. You can override this by using the -Force parameter in the Get-NtapFilerAsupData
    function.


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

        Required?                    true
        Position?                    named
        Default value
        Accept pipeline input?       true (ByValue)
        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).

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

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

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

    -StartDate <String>
        The start date to search from (e.g., 2014-01-01).

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

    -EndDate <String>
        The end date to search to (e.g., 2014-06-01). (Default: Current Date)

        Required?                    false
        Position?                    named
        Default value                [datetime]::Now.ToString('yyyy-MM-dd')
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -Last <Int32>
        The number of days to search.

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

    -Start <Int32>
        The ASUP to start the search from. (Default: 1)

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

    -Limit <Int32>
        The number of ASUPs to return. (Default: 1)

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

    -Oldest [<SwitchParameter>]
        Returns the oldest ASUP (ASUP generated date).

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

    -ListOnly [<SwitchParameter>]
        Returns all ASUPs found. This is useful for manually selecting the ASUPIDs from
        the entire list found. This output cannot be passed to the Get-NtapFilerAsupData
        function.

        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
    None


OUTPUTS
    System.Xml.XmlElement


NOTES


        AUTHOR : Jason Cole
        REQUIRES : Internal connection to NetApp

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

    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 and performs the data collection.




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

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

    Finds the FIRST validated user_triggered ASUP set for the specified HA pair by searching between the dates
    specified and performs the data collection.




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

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

    Finds the LAST validated weekly ASUP set for the specified HA pair by searching between the dates specified
    and performs the data collection.




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

    PS>Find-NtapFilerAsup -System 'mtharvard:30020945!mtmassive:30020946' -Last 21 | 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 the last 21 days
    and performs the data collection




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

    PS>Find-NtapFilerAsup -System 'mtharvard:30020945!mtmassive:30020946' -Last 21 -ListOnly

    Returns all weekly ASUP sets for the specified HA pair, searching the last 21 days. These results cannot be
    passed to the Get-NtapFilerAsupData function and will only output to the screen. The ASUPIDs can be noted
    and used to gather the data instead.




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

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

    Finds the ASUPs by the specified ASUPIDs and performs the data collection.




    -------------------------- EXAMPLE 7 --------------------------

    PS>Find-NtapAsupSystemInfo -NodeName mtharvard | Find-NtapFilerAsup | Get-NtapFilerAsupData | Export-Clixml -Path
    'D:\Output\mtmassive_mtharvard-Asup_raw.xml'

    Performs a lookup for the specified controller, finds the ASUPs based on the results (for the HA Pair) and performs the data
    collection.





RELATED LINKS
    https://community.netapp.com/t5/NetAppDocs/bd-p/netappdocs
    Find-NtapAsupSystemInfo