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