Data ONTAP® PowerShell Toolkit

Switch to clustered Data ONTAP documentation.

Cmdlet: Invoke-NaPerfstat


NAME
Invoke-NaPerfstat

SYNOPSIS
Gather perfstat information.

SYNTAX
Invoke-NaPerfstat [[-Directory] <String>] [[-Vfiler] <String[]>] [-SampleInt
erval <Int32>] [-Time <Int32>] [-Iterations <Int32>] [-IterationSleepTime <I
nt32>] [-Controller <NaController>] [<CommonParameters>]


DESCRIPTION
Gather perfstat information.

This cmdlet performs a basic perfstat. Output files are in the Perfstat 8.1
format. The collected data conforms to the following restrictions:
- All data collection is done via SSH.
- Only FILER data is collected.
- No SystemShell commands are run.
- Stuttered statit commands are run in "full" mode. That is, the statit c
ommands are stuttered for the entire parallel command time duration.


PARAMETERS
-Directory <String>
Output directory to copy all resulting files.

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

-Vfiler <String[]>
Restrict vfiler commands to the given Vfilers.

Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SampleInterval <Int32>
Sysstat/statit frequency in seconds. Default value is based on the valu
e supplied for Time.

Time <= 60 SampleInterval = 1
60 < Time <= 300 SampleInterval = 10
300 < Time <= 600 SampleInterval = 30
Time > 600 SampleInterval = 60

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Time <Int32>
Time to run parallel commands in seconds. Default value is 120.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Iterations <Int32>
Number of iterations to run. Default value is 1.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-IterationSleepTime <Int32>
Number of seconds to sleep between iterations. Default value is 0.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

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 and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS



NOTES


Category: toolkit

-------------- Example 1 --------------

C:\PS>Invoke-NaPerfstat -Directory C:\perfstat -Iterations 2 -InterationSlee
pTime 30


Run a perfstat on the current controller with 2 iterations and 30 seconds be
tween iterations.






RELATED LINKS







 Data ONTAP® PowerShell Toolkit