NetAppDocs PowerShell Module

Get-NtapVserverAsupData


NAME
    Get-NtapVserverAsupData

SYNOPSIS
    Collects SVM specific data for ONTAP storage systems using ASUPs.


SYNTAX
    Get-NtapVserverAsupData [-Cluster] <String> [-Name <String[]>] [-AsupSubject <String>] [-Force] [<CommonParameters>]

    Get-NtapVserverAsupData [-AsupId] <String> [-Name <String[]>] [-Force] [<CommonParameters>]

    Get-NtapVserverAsupData [-AsupObject] <XmlElement[]> [-Name <String[]>] [-Force] [<CommonParameters>]


DESCRIPTION
    Uses the node ASUPs to gather as much SVM 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

    -Name <String[]>
        A list of data SVMs to gather the data for. If blank, the information for all data SVMs will
        be returned.

        Required?                    false
        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

    -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-NtapVserverAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' | Export-Clixml -Path
    'D:\den-cdot_Asup-SVM_raw.xml'

    Collects all SVM information from the cluster name and cluster uuid specified and saves the results to a .xml file for
    further processing.




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

    PS>Get-NtapVserverAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -Name vs0 | Export-Clixml -Path
    'D:\den-cdot_Asup-vs0_raw.xml'

    Collects SVM 'vs0' information from the cluster name and cluster uuid specified and saves the results to a .xml file for
    further processing.




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

    PS>Get-NtapVserverAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' -AsupSubject user_triggered |
    Export-Clixml -Path 'D:\den-cdot_Asup-SVM_raw.xml'

    Collects all SVM 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 4 --------------------------

    PS>Get-NtapvserverAsupData -Cluster 'den-cdot:394e82bf-485c-11e2-86b3-123478563412' | Format-NtapClusterData |
    Out-NtapDocument -WordFile 'D:\Output\den-cdot_Asup-SVM.docx' -ExcelFile 'D:\Output\den-cdot_Asup-SVM.xlsx'

    Collects all SVM information from the cluster name and cluster uuid specified, formats the data and creates
    the specified Word and Excel documents.




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

    PS>Get-NtapVserverAsupData -AsupId 2015012500120554!2015012423440127 | Export-Clixml -Path
    'D:\Output\den-cdot-Asup-SVM_raw.xml'

    Collects all SVM information using specific ASUPIDs.




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

    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-SVM_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