{"id":15971,"date":"2011-01-08T00:01:00","date_gmt":"2011-01-08T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/01\/08\/weekend-scripter-use-the-powershell-pipeline-with-data-ontap-powershell-toolkit\/"},"modified":"2011-01-08T00:01:00","modified_gmt":"2011-01-08T00:01:00","slug":"weekend-scripter-use-the-powershell-pipeline-with-data-ontap-powershell-toolkit","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/weekend-scripter-use-the-powershell-pipeline-with-data-ontap-powershell-toolkit\/","title":{"rendered":"Weekend Scripter: Use the PowerShell Pipeline with Data ONTAP PowerShell Toolkit"},"content":{"rendered":"

 <\/span>\nSummary:<\/span><\/b> The Data ONTAP Windows PowerShell toolkit uses the pipeline to simplify data storage management.<\/span>\n <\/span>\nMicrosoft Scripting Guy Ed Wilson here. Today we have a guest blogger, Dr. Clinton Knight, from NetApp and the Author of Data ONTAP PowerShell Toolkit. I know not everyone has a NETAPP device and this will not be helpful to all readers but then again I blog a lot about Active Directory and other things that not everyone uses.  <\/span>The really cooI thing about Windows PowerShell as a management foundation, is that it enables you to perform management tasks without having to learn new tools. Therefore, if you know Windows PowerShell and you understand how to configure a NetApp device, you already know how to use the toolkit. The command discovery techniques are the same: Get-Help<\/b>, Get-Command<\/b> and Get-Member<\/b>. I hope that you will benefit from Dr. Knights information (it is worth a skim even if you do not have such a device on your network). Without further delay, I will turn the keyboard to Dr. Knight.<\/span>\nWith a Windows PowerShell module like NetApp’s Data ONTAP PowerShell Toolkit<\/span><\/a>, it is natural to ask how its cmdlets can best utilize the Windows PowerShell pipeline. But with over 400 cmdlets in that module, it is difficult to know where to begin chaining things together. This post should help understand how to get started.<\/span>\nMany Windows PowerShell cmdlets accept input via the pipeline, so let us begin by examining how pipeline objects are mapped to cmdlet parameters using a Toolkit example:<\/span><\/p>\n

PS C:> Get-Help Set-NaLunSpaceReserved –Full<\/span><\/span><\/p>\n

 <\/span><\/span><\/p>\n

…<\/span><\/span><\/p>\n

PARAMETERS<\/span><\/span><\/p>\n

    <\/span>-Path <String><\/span><\/span><\/p>\n

        <\/span>Path to the LUN for which the space reservations need to be set.<\/span><\/span><\/p>\n

 <\/span><\/span><\/p>\n

        <\/span>Required?                    <\/span>true<\/span><\/span><\/p>\n

        <\/span>Position?                    <\/span>1<\/span><\/span><\/p>\n

        <\/span>Default value<\/span><\/span><\/p>\n

        <\/span>Accept pipeline input?       <\/span>true (ByValue, ByPropertyName)<\/b><\/span><\/span><\/p>\n

        <\/span>Accept wildcard characters?  <\/span>false<\/span><\/span><\/p>\n

…<\/span><\/span>\n <\/span>\nNote here that the -Path<\/b> parameter to Set-NaLunSpaceReserved<\/b> may be set using pipeline input, either by value or by property name. ByValue<\/b> means that if a string is piped into this cmdlet, it will be assigned directly to -Path<\/b>. ByPropertyName<\/b> means that if any nonstring object is piped in which has a property named Path<\/b>. The value of that property will be assigned to -Path<\/b>.<\/span>\nWe know that Get-NaLun<\/b> returns LUN objects that have a Path<\/b> property. Therefore, we can pipe those objects into Set-NaLunSpaceReserved<\/b> with confidence that each LUN will be identified by its Path<\/b> property:<\/span><\/p>\n

PS C:> Get-NaLun | Set-NaLunSpaceReserved -Off<\/span><\/span>\n <\/span>\nOf course, unrelated object types could also have a Path<\/b> property. This example works for Windows PowerShell but makes no sense to Data ONTAP:<\/span><\/p>\n

PS C:> Get-NaSis | Set-NaLunSpaceReserved –Off<\/span><\/span>\n <\/span>\nSo is there any logical organization in the Toolkit that lets us make assumptions about how to best leverage the pipeline? Absolutely! The Toolkit defines a number of principal data types that represent Data ONTAP constructs, such as aggregates, volumes, qtrees, or LUNs. Each of these has a get cmdlet, such as Get-NaAggr<\/b> or Get-NaVol<\/b> , that writes those objects to the pipeline. So it is reasonable (and correct!) to expect that any set cmdlets that manipulate those objects should accept pipeline input from the corresponding getter:<\/span><\/p>\n

PS C:> Get-NaVol *clone | Set-NaVol -Offline<\/span><\/span>\n <\/span>\nAdditionally, the setter cmdlets that accept pipeline input typically perform their function, re-query Data ONTAP, and write the updated representation of those same objects back out to the pipeline. This enables chaining of multiple cmdlets, such as in this example that configures and starts deduplication on every volume on a controller:<\/span><\/p>\n

PS C:> Get-NaVol | Enable-NaSis | Set-NaSis -Schedule auto | Start-NaSis<\/span><\/span>\n <\/span>\nSimilarly, get cmdlets that retrieve various attributes of the principal objects can also accept those as pipeline input:<\/span><\/p>\n

PS C:> Get-NaLun | Get-NaLunMap<\/span><\/span>\n <\/span>\nAnd filtering pipeline objects by using Where-Object<\/b> works with all the above:<\/span><\/p>\n

PS C:> Get-NaAggr | Where-Object {$_.PlexCount -EQ 2} | Start-NaAggrVerify<\/span><\/span>\n <\/span>\nThere are a few cases in the Toolkit where it is not obvious, even by inspection of Get-Help<\/b> output, that pipeline input should work.  <\/span>For example, Set-NaIgroup<\/b> has a -Name<\/b> parameter but Get-NaIgroup<\/b> returns objects that have the names in a property named InitiatorGroupName<\/b>.  <\/span>Yet this example still works, enabling ALUA on all iSCSI igroups:<\/span><\/p>\n

PS C:> Get-NaIgroup | ? {$_.InitiatorGroupType -EQ “iscsi”} | Set-NaIgroup -Key alua -Value true<\/span><\/span>\n <\/span>\nThe unsung heroes here are parameter aliases on many Toolkit cmdlets, which enable shorthand notation or help with “impedance matching” within the pipeline. Windows PowerShell’s Get-Help<\/b> cmdlet does not display parameter aliases, but something such as this will reveal them:<\/span><\/p>\n

PS C:> (gcm Set-NaIgroup).Parameters | % { $_.Values | ? { $_.Aliases.Count -GT 0 } | select Name, Aliases } | ft –Autosize<\/span><\/span><\/p>\n

Name            <\/span>Aliases<\/span><\/span><\/p>\n

—-            <\/span>——-<\/span><\/span><\/p>\n

Name            <\/span>{Igroup, InitiatorGroupName}<\/span><\/span><\/p>\n

Key             <\/span>{Attribute}<\/span><\/span><\/p>\n

Controller      <\/span>{Filer, Server}<\/span><\/span><\/p>\n

…<\/span><\/span>\n <\/span>\nThe Toolkit’s cmdlet help contains real usage examples for almost every cmdlet. This includes many that demonstrate use within the pipeline. Just use Get-Help<\/b> -Examples<\/b> or Show-NaHelp<\/b> to see those.<\/span>\nHere are some other examples to get you thinking about how to use the pipeline.<\/span>\nDisable quotas on volume ‘vol0’ and show the new status:<\/span><\/b><\/p>\n

Disable-NaVolQuota vol0 | Get-NaVolQuotaStatus<\/span><\/span>\n <\/span>\nGet all valid licenses and store in an XML file:<\/span><\/b><\/p>\n

Get-NaLicense | ? {$_.Code -ne $null} | Export-Clixml c:OntapLicenses.xml<\/span><\/span>\n <\/span>\nAdd all licenses that were previously written to an XML file:<\/span><\/b><\/p>\n

Import-Clixml C:OntapLicenses.xml | Add-NaLicense<\/span><\/span>\n <\/span>\nFor a given LUN, get the initiator(s) it is mapped to and then list all other LUNs that are mapped to the same initiators:<\/span><\/b><\/p>\n

Get-NaLun \/vol\/vol2\/lun2 | Get-NaLunMap | ForEach-Object {$_.Initiators} | Get-NaLunMapByInitiator<\/span><\/span>\n <\/span>\nList the priority schedule for volumes from the pipeline:<\/span><\/b><\/p>\n

Get-NaVol vol0 vol1 | Get-NaPriorityVolume<\/span><\/span>\n <\/span>\nGet environmental information for all disk shelves:<\/span><\/b><\/p>\n

Get-NaShelf | Get-NaShelfEnvironment<\/span><\/span>\n <\/span>\nAbort all Snapmirror transfers:<\/span><\/b><\/p>\n

Get-NaSnapmirror | Invoke-NaSnapmirrorAbort<\/span><\/span>\n <\/span>\nSet the specified Snapmirror to synchronous mode:<\/span><\/b><\/p>\n

Get-NaSnapmirror benson:dunn_vol2_mirror | Set-NaSnapmirrorSyncSchedule<\/span><\/span>\n <\/span>\nSet the snapshot reserve on volume ‘vol0’ to 10% and print the result:<\/span><\/b><\/p>\n

Set-NaSnapshotReserve vol0 10 | Get-NaSnapshotReserve<\/span><\/span>\n <\/span>\nCopy the snapshot schedule from volume ‘vol2’ to all volumes:<\/span><\/b><\/p>\n

Get-NaVol | Set-NaSnapshotSchedule -Schedule ( Get-NaSnapshotSchedule vol2 ) | Get-NaSnapshotSchedule<\/span><\/span>\n <\/span>\nBegin updating firmware on all disks in shelf 1:<\/span><\/b><\/p>\n

Get-NaDisk | where {$_.Shelf -eq 1} | Start-NaDiskUpdate<\/span><\/span>\n <\/span>\nAll potentially destructive cmdlets in the Toolkit support Windows PowerShell’s -WhatIf<\/b> mechanism, and more will over time. So, do not hesitate to experiment with piping Toolkit objects between cmdlets. The object-oriented pipeline is part of what sets Windows PowerShell apart from other command shells, and the Data ONTAP PowerShell Toolkit was designed from the start to support it.<\/span>\n <\/span>\nI want to thank Dr. Knight for sharing with us today. Come back tomorrow when Sean Kearney will be the guest blogger on XML. The post is way cool, and you will really enjoy it.<\/span>\nI invite you to follow me on Twitter<\/span><\/a> or Facebook<\/span><\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/span><\/a> or post them on the Official Scripting Guys Forum<\/span><\/a>. See you tomorrow. Until then, peace.<\/span>\n <\/span>\nEd Wilson, Microsoft Scripting Guy<\/span><\/b><\/p>\n","protected":false},"excerpt":{"rendered":"

  Summary: The Data ONTAP Windows PowerShell toolkit uses the pipeline to simplify data storage management.   Microsoft Scripting Guy Ed Wilson here. Today we have a guest blogger, Dr. Clinton Knight, from NetApp and the Author of Data ONTAP PowerShell Toolkit. I know not everyone has a NETAPP device and this will not be […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[213,56,3,12,61,45],"class_list":["post-15971","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-clinton-knight","tag-guest-blogger","tag-scripting-guy","tag-storage","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Summary: The Data ONTAP Windows PowerShell toolkit uses the pipeline to simplify data storage management.   Microsoft Scripting Guy Ed Wilson here. Today we have a guest blogger, Dr. Clinton Knight, from NetApp and the Author of Data ONTAP PowerShell Toolkit. I know not everyone has a NETAPP device and this will not be […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/15971","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=15971"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/15971\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=15971"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=15971"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=15971"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}