NetAppDocs PowerShell Module

Find-NtapClusterAsup


NAME
    Find-NtapClusterAsup

SYNOPSIS
    Finds a specific ASUP set for an ONTAP storage system.


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

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

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

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


DESCRIPTION
    Queries the ASUP database to find specific ASUPIDs for a NetApp cDOT storage system. 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-NtapClusterAsupData function. The -ListOnly
    parameter will return all ASUPs found but the output cannot be passed to the Get-NtapClusterAsupData
    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 every node in the cluster is present and that each ASUP in the set was generated within an hour
    of all others in the set. You can override this by using the -Force parameter in the Get-NtapClusterAsupData
    function.


PARAMETERS
    -Cluster <Object>
        The cluster name and identifier (UUID) of the cluster to search for (e.g., den-cdot:394e82bf-485c-11e2-86b3-123478563412).

        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 cluster 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. This output cannot be passed to the Get-NtapClusterAsupData 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-NtapClusterAsup -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -StartDate 10-15-2014 -EndDate 11-15-2014 |
    Get-NtapClusterAsupData | Export-Clixml -Path 'D:\Output\den-cdot_Asup_raw.xml'

    Finds the FIRST validated weekly ASUP set for the specified cluster by searching between the dates
    specified and performs the data collection.




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

    PS>Find-NtapClusterAsup -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -StartDate 10-15-2014 -EndDate 11-15-2014
    -AsupSubject user_triggered | Get-NtapClusterAsupData | Export-Clixml -Path 'D:\Output\den-cdot_Asup_raw.xml'

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




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

    PS>Find-NtapClusterAsup -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -StartDate 10-15-2014 -EndDate 11-15-2014
    -Oldest | Get-NtapClusterAsupData | Export-Clixml -Path 'D:\Output\den-cdot_Asup_raw.xml'

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




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

    PS>Find-NtapClusterAsup -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -Last 21 | Get-NtapClusterAsupData |
    Export-Clixml -Path 'D:\Output\den-cdot_Asup_raw.xml'

    Finds the first validated weekly ASUP set for the specified cluster by searching the last 21 days
    and performs the data collection




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

    PS>Find-NtapClusterAsup -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -Last 21 -ListOnly

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




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

    PS>Find-NtapClusterAsup -AsupId 2020052400060017!2020052400220591 | Get-NtapClusterAsupData | Export-Clixml -Path
    'D:\Output\den-cdot_Asup_raw.xml'

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




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

    PS>Find-NtapAsupSystemInfo -Cluster 'den-cdot' | Find-NtapClusterAsup | Get-NtapClusterAsupData | Export-Clixml -Path
    'D:\Output\den-cdot_Asup_raw.xml'

    Performs a lookup for the specified cluster, finds the ASUPs based on the results (for all nodes in the cluster) and performs
    the data collection.





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