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