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