|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Get-NcAggr
NAME
Get-NcAggr
SYNOPSIS
Gets the aggregates for the current controller.
SYNTAX
Get-NcAggr [[-Name] <String[]>] [-Attributes <AggrAttributes>] [-Controller
<NcController[]>] [<CommonParameters>]
Get-NcAggr -Template [-Fill] [-Controller <NcController[]>] [<CommonParamete
rs>]
Get-NcAggr -Query <AggrAttributes> [-Attributes <AggrAttributes>] [-Controll
er <NcController[]>] [<CommonParameters>]
DESCRIPTION
Gets the aggregates for the current controller.
PARAMETERS
-Name <String[]>
The name of one or more aggregates to get. Data ONTAP wildcards are per
mitted.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Attributes <AggrAttributes>
For improved scalability in large clusters, provide an AggrAttributes ob
ject with various fields set to indicate which fields to return on all o
bjects. Undesired fields should remain set to null. Use "Get-NcAggr -T
emplate" to get the initially empty AggrAttributes object. If not speci
fied, all data is returned for each object.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A Data ONTAP cluster-mode controller to receive this cmdlet, as embodied
by an NcController object. This parameter is returned by the Connect-N
cController cmdlet. If not specified, the value in the global variable
CurrentNcController is used. In the latter case, if CurrentNcController
contains a collection of NcController objects, this cmdlet is invoked o
n each controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Template
Specify to get an empty AggrAttributes object for use with advanced quer
ies involving the Query attribute.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Fill
Specify when using the Template parameter to recursively fill in all obj
ect types.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Query <AggrAttributes>
For advanced queries, provide an AggrAttributes object with various fiel
ds set to indicate which records to retrieve. Other fields should remai
n set to null. Use "Get-NcAggr -Template" to get the initially empty Ag
grAttributes object.
Required? true
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
NetApp.Ontapi.Filer.C.Aggr810.AggrAttributes
NOTES
Category: aggr
API: aggr-get-iter
Family: cluster
-------------- Example 1 --------------
C:\PS>Get-NcAggr
Get all aggregates.
Name State TotalSize Used Available Disks RaidT
ype RaidSize Volumes
---- ----- --------- ---- --------- ----- -----
--- -------- -------
aggr0 online 119.5 GB 95% 5.6 GB 3 raid_
dp,normal 16 1
aggr0_fas3070cluster01... online 119.5 GB 95% 5.6 GB 3 raid_
dp,normal 16 1
aggr1 online 717.1 GB 3% 696.9 GB 8 raid_
dp,normal 16 4
-------------- Example 2 --------------
C:\PS>Get-NcAggr aggr1 | select State, TotalSize, Used | ft -AutoSize
Get aggregate 'aggr1' and display a subset of its attributes.
State TotalSize Used
----- --------- ----
online 769958141952 3
-------------- Example 3 --------------
C:\PS>Get-NcAggr -Attributes space,volumecount | select Name, TotalSize, Use
d, Volumes | ft -AutoSize
Restrict the amount of data transmitted by using the Attributes field.
Name TotalSize Used Volumes
---- --------- ---- -------
aggr0 128326377472 95 1
aggr0_fas3070cluster01_02_0 128326377472 95 1
aggr1 769958141952 3 4
-------------- Example 4 --------------
C:\PS>$a = Get-NcAggr -Template
Initialize-NcObjectProperty $a AggrSpaceAttributes
$a.AggrSpaceAttributes.PercentUsedCapacity = ">85"
Get-NcAggr -Query $a | select Name, Used | ft -AutoSize
Using an advanced query, discover which aggregates are more than 85% full.
Name Used
---- ----
aggr0 95
aggr0_fas3070cluster01_02_0 95
RELATED LINKS
New-NcAggr
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|