NAME
Get-NtapClusterAsupData
SYNOPSIS
Collects data for ONTAP storage systems using ASUPs.
SYNTAX
Get-NtapClusterAsupData [-Cluster] <String[]> [-AsupSubject <String>] [-Force] [<CommonParameters>]
Get-NtapClusterAsupData [-AsupId] <String[]> [-Force] [<CommonParameters>]
Get-NtapClusterAsupData [-AsupObject] <XmlElement[]> [-Force] [<CommonParameters>]
DESCRIPTION
Uses the node ASUPs to gather as much configuration information as possible for the cluster. This
data can be used to automate build docs and health checks. It can also be used for historical
configuration information. If the -Cluster parameter is used, the latest ASUPs of the specified
AsupSubject type will be used. If older or specified ASUPs are desired, use the Find-NtapClusterAsup
function and pass those results to this function. The ASUPs will be validated to determine that an
ASUP from each node in the cluster is present, complete and generated at similar times.
PARAMETERS
-Cluster <String[]>
Searches the ASUP database for the specified ClusterName and ClusterIdentifier
(e.g., den-cdot:394e82bf-485c-11e2-86b3-123478563412).
Required? true
Position? 1
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). Sets of ASUPIDs from multiple
clusters 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-NtapClusterAsup function. This is used when using older ASUPs to
generate the data.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue)
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
-Force [<SwitchParameter>]
Forces the use of an invalid ASUP (i.e., ASUP content missing or mismatched generated dates between
the nodes in the cluster).
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-NtapClusterAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' | Export-Clixml -Path
'D:\den-cdot_Asup_raw.xml'
Collects the cluster information from the cluster name and cluster uuid specified and saves the results to a .xml file for
further processing.
-------------------------- EXAMPLE 2 --------------------------
PS>Get-NtapClusterAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -AsupSubject user_triggered |
Export-Clixml -Path 'D:\den-cdot_Asup_raw.xml'
Collects the cluster information from the cluster name and cluster uuid specified, using the latest
user_triggered ASUP set, and saves the results to a .xml file for further processing.
-------------------------- EXAMPLE 3 --------------------------
PS>Get-NtapClusterAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' | Format-NtapClusterData |
Out-NtapDocument -WordFile 'D:\Output\den-cdot_Asup.docx' -ExcelFile 'D:\Output\den-cdot_Asup.xlsx'
Collects the cluster information from the cluster name and cluster uuid specified, formats the data and creates
the specified Word and Excel documents.
-------------------------- EXAMPLE 4 --------------------------
PS>Get-NtapClusterAsupData -AsupId 2015012500120554!2015012423440127 | Export-Clixml -Path 'D:\Output\den-cdot-Asup_raw.xml'
Perform the data collection using specific ASUPIDs.
-------------------------- EXAMPLE 5 --------------------------
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, 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-NtapClusterData