NetAppDocs PowerShell Module

ConvertTo-NtapVserverData


NAME
    ConvertTo-NtapVserverData

SYNOPSIS
    Converts ONTAP data from the Get-NtapClusterData function to SVM specific data.


SYNTAX
    ConvertTo-NtapVserverData [-InputObject] <Object> [-VserverName <String[]>] [<CommonParameters>]


DESCRIPTION
    Produces SVM specific data from the raw output generated by Get-NtapClusterData. This is useful for collecting the
    data one time from the cluster and generating both the cluster documentation as well as the SVM specific documentation.


PARAMETERS
    -InputObject <Object>
        An Xml file created by the Get-NtapClusterData function (can also be *.xml.gz). Also accepts pipeline input from
        the Get-NtapClusterData function.

        Required?                    true
        Position?                    1
        Default value
        Accept pipeline input?       true (ByValue)
        Accept wildcard characters?  false

    -VserverName <String[]>
        The list of data SVM names to include in the output. If blank, all data SVMs will be included.

        Required?                    false
        Position?                    named
        Default value
        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.Management.Automation.PSCustomObject

    System.IO.FileInfo

    System.String


OUTPUTS
    System.Management.Automation.PSCustomObject


NOTES


        AUTHOR : Jason Cole

    -------------------------- EXAMPLE 1 --------------------------

    PS>Get-ChildItem -Path 'D:\Output\cluster1.xml' | ConvertTo-NtapVserverData | Format-NtapVserverData | Out-NtapDocument
    -WordFile 'D:\Output\cluster1-AllSVMs.docx'

    Reads the raw cluster data from the file cluster1.xml (generated via Get-NtapClusterData) and outputs the data for
    all the data SVMs to the Word document specified.




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

    PS>Get-ChildItem -Path 'D:\Output\cluster1.xml' | ConvertTo-NtapVserverData -VserverName vs_nfs, vs_cifs |
    Format-NtapVserverData | Out-NtapDocument -WordFile 'D:\Output\SVMs.docx'

    Reads the raw cluster data from the file cluster1.xml (generated via Get-NtapClusterData) and outputs the data for
    the SVMs 'vs_nfs' and 'vs_cifs' to the single Word document specified.




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

    PS>Get-ChildItem -Path 'D:\Output\cluster1.xml' | ConvertTo-NtapVserverData -VserverName vs_nfs, vs_cifs | ForEach-Object {
    $_ | Format-NtapVserverData | Out-NtapDocument -WordFile "D:\Output\SVM-$( $_.SystemName ).docx" }

    Reads the raw cluster data from the file cluster1.xml (generated via Get-NtapClusterData) and outputs the data for
    the SVMs 'vs_nfs' and 'vs_cifs' to separate Word documents.




    -------------------------- EXAMPLE 4 --------------------------

    PS>Get-NtapClusterData -Name cluster1 | ConvertTo-NtapVserverData | Format-NtapVserverData | Out-NtapDocument -WordFile
    'D:\Output\cluster1-AllSVMs.docx'

    Collects the data from the cluster 'cluster1' and outputs the information for all the data SVMs to the single
    document specified. This use case is not common, since you'd probably use Get-NtapVserverData instead.




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

    PS>Get-ChildItem -Path 'D:\Output\cluster1.xml' | ConvertTo-NtapVserverData | Format-NtapVserverData -SanitizeLevel 1 |
    Out-NtapDocument -WordFile 'D:\Output\cluster1-AllSVMs.docx'

    Reads the raw cluster data from the file cluster1.xml (generated via Get-NtapClusterData) and outputs the data for
    all the data SVMs to the Word document specified. Additionally, this will sanitize the IP address information.





RELATED LINKS
    https://community.netapp.com/t5/NetAppDocs/bd-p/netappdocs
    Get-NtapClusterData
    Format-NtapVserverData