en-US/DataONTAP.Host.dll-Help.xml
|
<?xml version="1.0" encoding="utf-8"?>
<helpItems xmlns="http://msh" schema="maml"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Add-NaHostIscsiConnection</command:name> <maml:description> <maml:para>Add a connection to an existing iSCSI session.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Add</command:verb> <command:noun>NaHostIscsiConnection</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Add a connection to an existing iSCSI session.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Add-NaHostIscsiConnection</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID to add connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>IP address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Add-NaHostIscsiConnection</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID to add connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>IP address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Credential</maml:name> <maml:description> <maml:para>The CHAP username/password to use to authenticate the target. If not specified, no authentication will be used when connecting to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >PSCredential</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Add-NaHostIscsiConnection</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID to add connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>IP address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusGenerate</maml:name> <maml:description> <maml:para>If specified, use RADIUS to generate user authentication credentials.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID to add connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt16</command:parameterValue> <dev:type> <maml:name>UInt16</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>IP address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Credential</maml:name> <maml:description> <maml:para>The CHAP username/password to use to authenticate the target. If not specified, no authentication will be used when connecting to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue> <dev:type> <maml:name>PSCredential</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>RadiusGenerate</maml:name> <maml:description> <maml:para>If specified, use RADIUS to generate user authentication credentials.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiSessionInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Add-NaHostIscsiConnection -SessionId fffffa800a2d7428-4000013700000056</dev:code> <dev:remarks> <maml:para>Add a connection to the given session.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>SessionId TargetName NumConnections NumDevices --------- ---------- -------------- ---------- fffffa800a2d7428-4000013700000056 iqn.1992-08.com.netapp:sn.149c3db9b3c... 3 0 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Remove-NaHostIscsiConnection</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Connect-NaHostIscsiTarget</command:name> <maml:description> <maml:para>Establish a connection to a target discovered by the iSCSI Initiator.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Connect</command:verb> <command:noun>NaHostIscsiTarget</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Establish a connection to a target discovered by the iSCSI Initiator.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Connect-NaHostIscsiTarget</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to connect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>Ip address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Persistent</maml:name> <maml:description> <maml:para>Specify this flag to add this target to the list of favorite targets. The iSCSI Initiator service ensures that all volumes and devices on a favorite target are available. It attempts to restore connections to these targets when this machine restarts.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>EnableMultipath</maml:name> <maml:description> <maml:para>If specified, multi-path will be enabled for the established connection.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Connect-NaHostIscsiTarget</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to connect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>Ip address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Persistent</maml:name> <maml:description> <maml:para>Specify this flag to add this target to the list of favorite targets. The iSCSI Initiator service ensures that all volumes and devices on a favorite target are available. It attempts to restore connections to these targets when this machine restarts.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Credential</maml:name> <maml:description> <maml:para>The CHAP username/password to use to authenticate the target. If not specified, no authentication will be used when connecting to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >PSCredential</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>EnableMultipath</maml:name> <maml:description> <maml:para>If specified, multi-path will be enabled for the established connection.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Connect-NaHostIscsiTarget</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to connect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt16</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>Ip address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Persistent</maml:name> <maml:description> <maml:para>Specify this flag to add this target to the list of favorite targets. The iSCSI Initiator service ensures that all volumes and devices on a favorite target are available. It attempts to restore connections to these targets when this machine restarts.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>EnableMultipath</maml:name> <maml:description> <maml:para>If specified, multi-path will be enabled for the established connection.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusGenerate</maml:name> <maml:description> <maml:para>If specified, use RADIUS to generate user authentication credentials.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to connect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>TargetIp</maml:name> <maml:description> <maml:para>IP address of the target portal to connect to. If not specified, the default IP address will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>TargetPort</maml:name> <maml:description> <maml:para>The target port to connect to. The default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt16</command:parameterValue> <dev:type> <maml:name>UInt16</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>InitiatorIp</maml:name> <maml:description> <maml:para>Ip address the initiator should use to connect to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Persistent</maml:name> <maml:description> <maml:para>Specify this flag to add this target to the list of favorite targets. The iSCSI Initiator service ensures that all volumes and devices on a favorite target are available. It attempts to restore connections to these targets when this machine restarts.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>HeaderDigest</maml:name> <maml:description> <maml:para>If specified, header digest will be enabled.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DataDigest</maml:name> <maml:description> <maml:para>If specified, data digest will be enabled.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>EnableMultipath</maml:name> <maml:description> <maml:para>If specified, multi-path will be enabled for the established connection.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Credential</maml:name> <maml:description> <maml:para>The CHAP username/password to use to authenticate the target. If not specified, no authentication will be used when connecting to the target.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue> <dev:type> <maml:name>PSCredential</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>MutualChap</maml:name> <maml:description> <maml:para>If specified, mutual CHAP will be used. To use mutual CHAP, an initiator CHAP secret must be set on the Configuration page of the iSCSI Initiator Properties.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>RadiusVerify</maml:name> <maml:description> <maml:para>If specified, use RADIUS to authenticate target credentials.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>RadiusGenerate</maml:name> <maml:description> <maml:para>If specified, use RADIUS to generate user authentication credentials.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiSessionInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Connect-NaHostIscsiTarget iqn.1992-08.com.netapp:sn.135107386</dev:code> <dev:remarks> <maml:para>Connect to the target with an Iqn of iqn.1992-08.com.netapp:sn.135107386.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Connections : {fffffa8003bb3018-000000000000001e} Devices : {\\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000000#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}, } NumConnections : 1 NumDevices : 2 SessionId : fffffa8003bb3018-400001370000001f InitiatorName : iqn.1991-05.com.microsoft:win2k8devrre0 TargetName : iqn.1992-08.com.netapp:sn.135107386 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiTarget | where { !$_.IsConnected} | Connect-NaHostIscsiTarget -Persistent</dev:code> <dev:remarks> <maml:para>Connect to all targets that are currently not connected and add them to the favorite targets list.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Connections : {fffffa8003bb3018-0000000000000022} Devices : {\\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000000#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}, } NumConnections : 1 NumDevices : 2 SessionId : fffffa8003bb3018-4000013700000023 InitiatorName : iqn.1991-05.com.microsoft:win2k8devrre0 TargetName : iqn.1992-08.com.netapp:sn.135107386 Connections : {fffffa8003bb3018-0000000000000023} Devices : {\\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000100#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}} NumConnections : 1 NumDevices : 1 SessionId : fffffa8003bb3018-4000013700000024 InitiatorName : iqn.1991-05.com.microsoft:win2k8devrre0 TargetName : iqn.1992-08.com.netapp:sn.135107303 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Add-NaHostIscsiTargetPortal</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Disconnect-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiSession</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>ConvertTo-NaLun</command:name> <maml:description> <maml:para>Create a LUN from a virtual hard disk (VHD or VHDX).</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>ConvertTo</command:verb> <command:noun>NaLun</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Create a LUN from a virtual hard disk (VHD or VHDX). The virtual hard disk file must reside on a Data ONTAP LUN. The path of the LUN to create must lie on the same volume as the LUN containing the VHD file or the cmdlet will fail. If the controller supplied in the Controller parameter is not the controller containing the VHD file, the cmdlet consults the credentials cache and attempts to connect via HTTPS. If credentials are not present in the credentials cache, an attempt to connect via RPC is made. If a connection cannot be made, the cmdlet will fail.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>ConvertTo-NaLun</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Virtual hard disk file to create a new LUN from.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationLun</maml:name> <maml:description> <maml:para>The path to give the new LUN. The new LUN must reside in the same volume as the LUN containing the source VHD.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reserved</maml:name> <maml:description> <maml:para>If specified, the created LUN will have space reservation enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>Type</maml:name> <maml:description> <maml:para>OS type to give the created LUN. If not specified, the created LUN will have the type "windows_2008". Issue "help New-NaLun -Parameter Type" for more information on LUN OS types. The following types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "4" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning. </maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaLun</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>VHDX file from which to create a LUN.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationLun</maml:name> <maml:description> <maml:para>The path to give the new LUN. The new LUN must reside in the same volume as the LUN containing the source VHD.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reserved</maml:name> <maml:description> <maml:para>If specified, the created LUN will have space reservation enabled.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>Type</maml:name> <maml:description> <maml:para>OS type to give the created LUN. If not specified, the created LUN will have the type "windows_2008". Issue "help New-NaLun -Parameter Type" for more information on LUN OS types. The following types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "4" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning. </maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Virtual hard disk file to create a new LUN from.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>DestinationLun</maml:name> <maml:description> <maml:para>The path to give the new LUN. The new LUN must reside in the same volume as the LUN containing the source VHD.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Reserved</maml:name> <maml:description> <maml:para>If specified, the created LUN will have space reservation enabled.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="3"> <maml:name>Type</maml:name> <maml:description> <maml:para>OS type to give the created LUN. If not specified, the created LUN will have the type "windows_2008". Issue "help New-NaLun -Parameter Type" for more information on LUN OS types. The following types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="4"> <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning. </maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>VHDX file from which to create a LUN.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.Types.Lun.LunInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaLun E:\VM1.vhd /vol/vol4/fromVhd</dev:code> <dev:remarks> <maml:para>Convert the VHD file VM1.vhd into a LUN.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Path TotalSize SizeUsed Protocol Online Mapped Thin Comment ---- --------- -------- -------- ------ ------ ---- ------- /vol/vol4/fromVhd 20.0 GB 136.6 MB windows_2008 True False True </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaLun -SourceVhdx F:\VHDX\disk1.vhdx -DestinationLun /vol/vol2/luns/disk1 -Type windows_2008</dev:code> <dev:remarks> <maml:para>Create a LUN from the given VHDX file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Path TotalSize SizeUsed Protocol Online Mapped Thin Comment ---- --------- -------- -------- ------ ------ ---- ------- /vol/vol2/luns/disk1 10.0 GB 75.6 MB windows_2008 True False True </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>ConvertTo-NaVhd</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>ConvertTo-NaVhd</command:name> <maml:description> <maml:para>Convert a VMDK file, a VHDX file, a dynamic VHD file, or a Data ONTAP LUN into a VHD file.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>ConvertTo</command:verb> <command:noun>NaVhd</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Convert a VMDK file, a VHDX file, a dynamic VHD file, or a Data ONTAP LUN into a VHD file. A VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". When converting from a Data ONTAP LUN, the destination VHD file must reside on a different LUN in the same volume. The source and destination files must reside inside of a Data ONTAP volume (accessed using a path starting with /vol/<volname>), a Data ONTAP attached LUN, or a Data ONTAP CIFS share (accessed using a mapped network drive or a UNC path starting with \\hostname\<share>). The source and destination files must reside on the same controller and volume. If the controller supplied in the Controller parameter is not the controller containing the files, the cmdlet consults the credentials cache and attempts to connect via HTTPS. If credentials are not present in the credentials cache, an attempt to connect via RPC is made. If a connection cannot be made, the cmdlet will fail.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>ConvertTo-NaVhd</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SourceVmdk</maml:name> <maml:description> <maml:para>Path to the source VMDK file. The VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>). Note: This cmdlet can convert a VMDK that is being used by a running VM. Be sure to shutdown the VM or quiesce the filesystem before running this cmdlet. Failing to do so may result in an inconsistent or corrupt result.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Win2k3ScsiToIde</maml:name> <maml:description> <maml:para>Use this switch when converting a Windows Server 2003 SCSI VMDK to VHD. When specified, the cmdlet will perform the necessary steps to ensure the required IDE drivers are present on the virtual disk.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>FollowParent</maml:name> <maml:description> <maml:para>If specified, the parser will follow the VMDK parent descriptor and use the base VMDK for the clone operation.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhd</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SourceLun</maml:name> <maml:description> <maml:para>Path of a LUN to convert to a VHD file. Must start with /vol/<volname>/. The following LUN types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhd</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SourceDiskIndex</maml:name> <maml:description> <maml:para>A Windows disk index of the disk to convert to a VHD. The disk index must reference a Data ONTAP LUN or the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhd</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Absolute path to a dynamic VHD file to convert to a fixed VHD file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>ForceHostCopy</maml:name> <maml:description> <maml:para>If specified, the cmdlet will not attempt to offload any of the copying associated with converting a dynamic VHD to a fixed VHD to Data ONTAP. A host-based copy will use SCSI XCOPY when available, otherwise data will be copied from the source to the host, then from the host to the destination.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhd</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>Absolute path to a VHDX file to convert to a VHD.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>SourceVmdk</maml:name> <maml:description> <maml:para>Path to the source VMDK file. The VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>). Note: This cmdlet can convert a VMDK that is being used by a running VM. Be sure to shutdown the VM or quiesce the filesystem before running this cmdlet. Failing to do so may result in an inconsistent or corrupt result.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>DestinationVhd</maml:name> <maml:description> <maml:para>Path to the destination VHD file. If not supplied, the VHD file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Win2k3ScsiToIde</maml:name> <maml:description> <maml:para>Use this switch when converting a Windows Server 2003 SCSI VMDK to VHD. When specified, the cmdlet will perform the necessary steps to ensure the required IDE drivers are present on the virtual disk.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>FollowParent</maml:name> <maml:description> <maml:para>If specified, the parser will follow the VMDK parent descriptor and use the base VMDK for the clone operation.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="3"> <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SourceLun</maml:name> <maml:description> <maml:para>Path of a LUN to convert to a VHD file. Must start with /vol/<volname>/. The following LUN types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SourceDiskIndex</maml:name> <maml:description> <maml:para>A Windows disk index of the disk to convert to a VHD. The disk index must reference a Data ONTAP LUN or the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Absolute path to a dynamic VHD file to convert to a fixed VHD file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceHostCopy</maml:name> <maml:description> <maml:para>If specified, the cmdlet will not attempt to offload any of the copying associated with converting a dynamic VHD to a fixed VHD to Data ONTAP. A host-based copy will use SCSI XCOPY when available, otherwise data will be copied from the source to the host, then from the host to the destination.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>Absolute path to a VHDX file to convert to a VHD.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd E:\Windows7_VM1.vmdk</dev:code> <dev:remarks> <maml:para>Converts the VMDK file to a VHD file. The VHD file will be named "Windows7_VM1.vhd".</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/22/2011 10:30 AM 30064771584 Windows7_VM1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd \\benson\vol4\VMDKs\Windows7.vmdk \\benson\vol4\VHDs\Windows7.vhd</dev:code> <dev:remarks> <maml:para>Converts the VMDK file on the vol4 share on benson into a VHD file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/22/2011 10:44 AM 30064771584 Windows7.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd /vol/vol4/VMDKs/Windows7.vmdk /vol/vol4/VHDs/Windows7.vhd</dev:code> <dev:remarks> <maml:para>Performs the same conversion as example 2, except it uses the direct path on the controller to the file. This is useful if there is no CIFS share providing access to the VMDK file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Name Type Size Created Modified Owner Group Perm Empty ---- ---- ---- ------- -------- ----- ----- ---- ----- /vol/vol4/VHDs/Windows7.vhd file 28 GB 11/22/2011 11/22/2011 0 0 1077 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 4 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd -SourceDiskIndex 2 -DestinationVhd E:\fromLUN.vhd</dev:code> <dev:remarks> <maml:para>Convert the LUN that is presented as disk 2 into a VHD file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 2/10/2012 2:33 PM 21474836992 fromLUN.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 5 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd -SourceVhd E:\dynamic.vhd -DestinationVhd E:\fixed.vhd</dev:code> <dev:remarks> <maml:para>Convert the dynamic VHD into a fixed VHD.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 2/10/2012 2:44 PM 4294967808 fixed.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 6 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhd -SourceVhdx F:\VHDX\disk1.vhdx -DestinationVhd F:\VHD\disk1.vhd</dev:code> <dev:remarks> <maml:para>Convert the disk1.vhdx file into a VHD.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/21/2012 10:32 AM 10770973184 disk1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>ConvertTo-NaVmdk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>ConvertTo-NaVhdx</command:name> <maml:description> <maml:para>Convert a VMDK file, a fixed VHD file, or a Data ONTAP LUN into a VHDX file.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>ConvertTo</command:verb> <command:noun>NaVhdx</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Convert a VMDK file, a fixed VHD file, or a Data ONTAP LUN into a VHDX file. A VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". When converting from a Data ONTAP LUN, the destination VHD file must reside on a different LUN in the same volume. The source and destination files must reside inside of a Data ONTAP volume (accessed using a path starting with /vol/<volname>), a Data ONTAP attached LUN, or a Data ONTAP CIFS share (accessed using a mapped network drive or a UNC path starting with \\hostname\<share>). The source and destination files must reside on the same controller and volume. If the controller supplied in the Controller parameter is not the controller containing the files, the cmdlet consults the credentials cache and attempts to connect via HTTPS. If credentials are not present in the credentials cache, an attempt to connect via RPC is made. If a connection cannot be made, the cmdlet will fail.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>ConvertTo-NaVhdx</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue)" position = "1" > <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Absolute path to a fixed VHD file to convert to a VHDX file. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>DestinationVhdx</maml:name> <maml:description> <maml:para>Absolute path to the destination VHDX file. The file must not yet exist. If not specified and the source is either a VHD or VMDK, the destination VHDX will be created in the same directory alongside the source. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhdx</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue)" position = "named" > <maml:name>SourceVmdk</maml:name> <maml:description> <maml:para>Path to the source VMDK file. The VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/). Note: This cmdlet can convert a VMDK that is being used by a running VM. Be sure to shutdown the VM or quiesce the filesystem before running this cmdlet. Failing to do so may result in an inconsistent or corrupt result.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>DestinationVhdx</maml:name> <maml:description> <maml:para>Absolute path to the destination VHDX file. The file must not yet exist. If not specified and the source is either a VHD or VMDK, the destination VHDX will be created in the same directory alongside the source. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Win2k3ScsiToIde</maml:name> <maml:description> <maml:para>Use this switch when converting a Windows Server 2003 SCSI VMDK to VHDX. When specified, the cmdlet will perform the necessary steps to ensure the required IDE drivers are present on the virtual disk.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>FollowParent</maml:name> <maml:description> <maml:para>If specified, the parser will follow the VMDK parent descriptor and use the base VMDK for the clone operation.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhdx</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SourceLun</maml:name> <maml:description> <maml:para>Path of a LUN to convert to a VHDX file. Must start with /vol/<volname>/. The following LUN types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>DestinationVhdx</maml:name> <maml:description> <maml:para>Absolute path to the destination VHDX file. The file must not yet exist. If not specified and the source is either a VHD or VMDK, the destination VHDX will be created in the same directory alongside the source. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVhdx</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SourceDiskIndex</maml:name> <maml:description> <maml:para>A Windows disk index of the disk to convert to a VHD. The disk index must reference a Data ONTAP LUN or the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>DestinationVhdx</maml:name> <maml:description> <maml:para>Absolute path to the destination VHDX file. The file must not yet exist. If not specified and the source is either a VHD or VMDK, the destination VHDX will be created in the same directory alongside the source. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue)" position="1"> <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Absolute path to a fixed VHD file to convert to a VHDX file. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="2"> <maml:name>DestinationVhdx</maml:name> <maml:description> <maml:para>Absolute path to the destination VHDX file. The file must not yet exist. If not specified and the source is either a VHD or VMDK, the destination VHDX will be created in the same directory alongside the source. The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="3"> <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue)" position="named"> <maml:name>SourceVmdk</maml:name> <maml:description> <maml:para>Path to the source VMDK file. The VMDK file must be of type "vmfs", "monolithicFlat", or "twoGbMaxExtentFlat". The path can be a path to a file on a Data ONTAP LUN, a path to a file on a Data ONTAP CIFS share (either a mapped network drive, or a UNC path starting with \\hostname\share), or a path to a file on a Data ONTAP controller (starting with /vol/<volname/). Note: This cmdlet can convert a VMDK that is being used by a running VM. Be sure to shutdown the VM or quiesce the filesystem before running this cmdlet. Failing to do so may result in an inconsistent or corrupt result.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Win2k3ScsiToIde</maml:name> <maml:description> <maml:para>Use this switch when converting a Windows Server 2003 SCSI VMDK to VHDX. When specified, the cmdlet will perform the necessary steps to ensure the required IDE drivers are present on the virtual disk.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>FollowParent</maml:name> <maml:description> <maml:para>If specified, the parser will follow the VMDK parent descriptor and use the base VMDK for the clone operation.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SourceLun</maml:name> <maml:description> <maml:para>Path of a LUN to convert to a VHDX file. Must start with /vol/<volname>/. The following LUN types are supported: windows_2008, hyper_v, linux, aix, hpux, netware, vmware, xen</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SourceDiskIndex</maml:name> <maml:description> <maml:para>A Windows disk index of the disk to convert to a VHD. The disk index must reference a Data ONTAP LUN or the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhdx -SourceVhd F:\VHD\win2k8r2.vhd -DestinationVhdx F:\VHDX\win2k8r2.vhdx</dev:code> <dev:remarks> <maml:para>Convert a VHD file to a VHDX file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/16/2012 3:05 PM 26847739904 win2k8r2.vhdx </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhdx -SourceVMDK X:\VMDK\Monolithic\win2k8r2.vmdk -DestinationVhdx X:\VHDX\win2k8r2.vhdx</dev:code> <dev:remarks> <maml:para>Convert a VMDK file in a CIFS share into a VHDX file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/16/2012 3:00 PM 26847739904 win2k8r2.vhdx </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhdx -SourceVMDK /vol/vol2/cifs/VMDK/Monolithic/win2k8r2.vmdk -DestinationVhdx /vol/vol2/cifs/VHDX/win2k8r2.vhdx</dev:code> <dev:remarks> <maml:para>Performs the same operation as Example 2, except it uses the direct path on the controller to the file. This is useful if there is no CIFS share providing access to the VMDK file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Name Type Size Created Modified Owner Group Perm Empty ---- ---- ---- ------- -------- ----- ----- ---- ----- /vol/vol2/cifs/VHDX/win2k8r2.vhdx file 25 GB 8/16/2012 8/16/2012 0 0 1077 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 4 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVhdx -SourceLun /vol/vol2/luns/lun0 -DestinationVhdx F:\VHDX\fromLUN.vhdx</dev:code> <dev:remarks> <maml:para>Convert the Data ONTAP LUN into a VHDX.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/16/2012 3:38 PM 10775166976 fromLUN.vhdx </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>ConvertTo-NaVmdk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>ConvertTo-NaVmdk</command:name> <maml:description> <maml:para>Convert a VHD or VHDX file into a VMDK file.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>ConvertTo</command:verb> <command:noun>NaVmdk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Convert a VHD or VHDX file into a VMDK file. The source and destination files must reside inside of a Data ONTAP volume (accessed using a path starting with /vol/<volname>), a Data ONTAP attached LUN, or a Data ONTAP CIFS share (accessed using a mapped network drive or a UNC path starting with \\hostname\<share>). The source and destination files must reside on the same controller and volume. If the controller supplied in the Controller parameter is not the controller containing the files, the cmdlet consults the credentials cache and attempts to connect via HTTPS. If credentials are not present in the credentials cache, an attempt to connect via RPC is made. If a connection cannot be made, the cmdlet will fail.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>ConvertTo-NaVmdk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Path to the source VHD file. The path can be a path to the file on a Data ONTAP mounted LUN or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVmdk</maml:name> <maml:description> <maml:para>Path to the destination VMDK file. If not supplied, the VMDK file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>VmdkType</maml:name> <maml:description> <maml:para>The VMDK type of the VMDK file to be created. The supported types are: "vmfs", "monolithicFlat", and "twoGbMaxExtentFlat". If not provided, the type will be "vmfs".</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VmdkDescriptor+CreateType</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "4" > <maml:name>AdapterType</maml:name> <maml:description> <maml:para>The adapter type to assign the created VMDK. Supported values types are: "lsilogic", "buslogic", and "ide". If not provided, the type will be "lsilogic".</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VmdkDescriptor+AdapterType</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "5" > <maml:name>VirtualHwVersion</maml:name> <maml:description> <maml:para>Specify the virtual hardware version of the virtual machine which will use this disk. Default is 7 (supported on ESX/ESXi 4.x and later).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Byte</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>ConvertTo-NaVmdk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>Path to the source VHDX file. The path can be a path to the file on a Data ONTAP mounted LUN, a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>), or a path to a file residing on a Data ONTAP controller (starting with /vol/<volname>/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationVmdk</maml:name> <maml:description> <maml:para>Path to the destination VMDK file. If not supplied, the VMDK file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>VmdkType</maml:name> <maml:description> <maml:para>The VMDK type of the VMDK file to be created. The supported types are: "vmfs", "monolithicFlat", and "twoGbMaxExtentFlat". If not provided, the type will be "vmfs".</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VmdkDescriptor+CreateType</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "4" > <maml:name>AdapterType</maml:name> <maml:description> <maml:para>The adapter type to assign the created VMDK. Supported values types are: "lsilogic", "buslogic", and "ide". If not provided, the type will be "lsilogic".</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VmdkDescriptor+AdapterType</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "5" > <maml:name>VirtualHwVersion</maml:name> <maml:description> <maml:para>Specify the virtual hardware version of the virtual machine which will use this disk. Default is 7 (supported on ESX/ESXi 4.x and later).</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Byte</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>SourceVhd</maml:name> <maml:description> <maml:para>Path to the source VHD file. The path can be a path to the file on a Data ONTAP mounted LUN or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>DestinationVmdk</maml:name> <maml:description> <maml:para>Path to the destination VMDK file. If not supplied, the VMDK file will be created in the same directory as the source VMDK. The file must not exist. The path can be a path to the file on the controller (starting with /vol/<volname>), a path to the file on a Data ONTAP mounted LUN, or a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="3"> <maml:name>VmdkType</maml:name> <maml:description> <maml:para>The VMDK type of the VMDK file to be created. The supported types are: "vmfs", "monolithicFlat", and "twoGbMaxExtentFlat". If not provided, the type will be "vmfs".</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">VmdkDescriptor+CreateType</command:parameterValue> <dev:type> <maml:name>VmdkDescriptor+CreateType</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="4"> <maml:name>AdapterType</maml:name> <maml:description> <maml:para>The adapter type to assign the created VMDK. Supported values types are: "lsilogic", "buslogic", and "ide". If not provided, the type will be "lsilogic".</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">VmdkDescriptor+AdapterType</command:parameterValue> <dev:type> <maml:name>VmdkDescriptor+AdapterType</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="5"> <maml:name>VirtualHwVersion</maml:name> <maml:description> <maml:para>Specify the virtual hardware version of the virtual machine which will use this disk. Default is 7 (supported on ESX/ESXi 4.x and later).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Byte</command:parameterValue> <dev:type> <maml:name>Byte</maml:name> <maml:uri/> </dev:type> <dev:defaultValue>7</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SnapshotName</maml:name> <maml:description> <maml:para>The name of snapshot to be used during cloning.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>SourceVhdx</maml:name> <maml:description> <maml:para>Path to the source VHDX file. The path can be a path to the file on a Data ONTAP mounted LUN, a path to a Data ONTAP CIFS share (either a mapped network drive or a UNC path starting with \\hostname\<share>), or a path to a file residing on a Data ONTAP controller (starting with /vol/<volname>/).</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVmdk F:\VM1.vhd</dev:code> <dev:remarks> <maml:para>Convert the VHD into a VMDK. The VMDK will be given the name "VM1.vmdk".</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/22/2011 1:11 PM 680 VM1.vmdk -a--- 11/22/2011 1:11 PM 21474836480 VM1-flat.vmdk </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVmdk \\benson\vol4\VHDs\testvhd.vhd \\benson\vol4\VMDKs\testvmdk.vmdk -VmdkType twoGbMaxExtentFlat</dev:code> <dev:remarks> <maml:para>Converts the testvhd VHD into a VMDK of the twoGbMaxExtentFlat type.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/22/2011 1:52 PM 690 testvmdk.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f001.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f002.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f003.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f004.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f005.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f006.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f007.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f008.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f009.vmdk -a--- 11/22/2011 1:52 PM 2147483648 testvmdk-f010.vmdk </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>ConvertTo-NaVmdk -SourceVhdx F:\VHDX\disk1.vhdx -DestinationVmdk F:\VMDK\TwoGbMaxExtent\disk1.vmdk -AdapterType IDE -VmdkType TwoGbMaxExtentFlat</dev:code> <dev:remarks> <maml:para>Convert disk1.vhdx into a VMDK of type TwoGbMaxExtentFlat with an IDE adapter type.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/21/2012 10:40 AM 513 disk1.vmdk -a--- 8/21/2012 10:40 AM 2147483648 disk1-f001.vmdk -a--- 8/21/2012 10:40 AM 2147483648 disk1-f002.vmdk -a--- 8/21/2012 10:40 AM 2147483648 disk1-f003.vmdk -a--- 8/21/2012 10:40 AM 2147483648 disk1-f004.vmdk -a--- 8/21/2012 10:40 AM 2147483648 disk1-f005.vmdk -a--- 8/21/2012 10:40 AM 33554432 disk1-f006.vmdk </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>ConvertTo-NaVhd</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Copy-NaHostFile</command:name> <maml:description> <maml:para>Copy a file between LUNs mounted on a Windows host, or within a LUN mounted on a windows host.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Copy</command:verb> <command:noun>NaHostFile</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Copy a file between LUNs mounted on a Windows host, or within a LUN mounted on a windows host. The source and destination files must reside on LUNs contained in the same volume. The destination file must not already exist. If the controller supplied in the Controller parameter is not the controller containing the LUNs, the cmdlet consults the credentials cache and attempts to connect via HTTPS. If credentials are not present in the credentials cache, an attempt to connect via RPC is made. If a connection cannot be made, the cmdlet will fail. The source and destination files must be specified with a fully-qualified path that resides on a Data ONTAP LUN. Cluster-shared volumes (CSVs) are supported. Administrator privileges are required to use this cmdlet.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Copy-NaHostFile</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "1" > <maml:name>SourceFile</maml:name> <maml:description> <maml:para>Full path to the source file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>DestinationFile</maml:name> <maml:description> <maml:para>Full path to the destination file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Verify</maml:name> <maml:description> <maml:para>If specified, a warning will be emitted if the MD5 hash of the source and destination files are not the same.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="1"> <maml:name>SourceFile</maml:name> <maml:description> <maml:para>Full path to the source file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>DestinationFile</maml:name> <maml:description> <maml:para>Full path to the destination file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Verify</maml:name> <maml:description> <maml:para>If specified, a warning will be emitted if the MD5 hash of the source and destination files are not the same.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host API: clone-start</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Copy-NaHostFile H:\VM1.vhd I:\VM1_copy.vhd</dev:code> <dev:remarks> <maml:para>Copy the VHD file H:\VM1.vhd to I:\VM1_copy.vhd.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/16/2011 10:41 AM 3221221888 VM1_copy.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Remove-NaHostFile</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Restore-NaHostFile</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Disconnect-NaHostIscsiTarget</command:name> <maml:description> <maml:para>Disconnect the host from an iSCSI target.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Disconnect</command:verb> <command:noun>NaHostIscsiTarget</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Disconnect the host from an iSCSI target.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Disconnect-NaHostIscsiTarget</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SessionId</maml:name> <maml:description> <maml:para>The SessionId of the session to disconnect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to disconnect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SessionId</maml:name> <maml:description> <maml:para>The SessionId of the session to disconnect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to disconnect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Disconnect-NaHostIscsiTarget iqn.1992-08.com.netapp:sn.135107386</dev:code> <dev:remarks> <maml:para>Disconnect the target with an Iqn of iqn.1992-08.com.netapp:sn.135107386</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiTarget | where {$_.IsConnected} | Disconnect-NaHostIscsiTarget</dev:code> <dev:remarks> <maml:para>Disconnect all currently connected targets.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiSession</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Connect-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Dismount-NaHostVolume</command:name> <maml:description> <maml:para>Remove one or all mount points from a Windows volume.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Dismount</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Remove one or all mount points from a Windows volume. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Dismount-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>MountPoint</maml:name> <maml:description> <maml:para>An active drive letter (i.e. 'G') or folder mount point to remove from the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Dismount-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path. Specify this parameter directly or via the pipeline to remove all mount points from a single volume.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>MountPoint</maml:name> <maml:description> <maml:para>An active drive letter (i.e. 'G') or folder mount point to remove from the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path. Specify this parameter directly or via the pipeline to remove all mount points from a single volume.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Dismount-NaHostVolume J:\</dev:code> <dev:remarks> <maml:para>Remove the drive letter J:\ from the volume.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostVolume -DiskIndex 4 | Dismount-NaHostVolume</dev:code> <dev:remarks> <maml:para>Pass the volume object on the pipeline to remove all mount points (drive letter & folders) from a volume.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Dismount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Dismount-NaVirtualDisk</command:name> <maml:description> <maml:para>Dismounts a VHD file from the local host.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Dismount</command:verb> <command:noun>NaVirtualDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Dismounts a VHD file from the local host.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Dismount-NaVirtualDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified path of the VHD file to be dismounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Dismount-NaVirtualDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Disk</maml:name> <maml:description> <maml:para>The Windows disk index of the VHD file to be dismounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified path of the VHD file to be dismounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Disk</maml:name> <maml:description> <maml:para>The Windows disk index of the VHD file to be dismounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Dismount-NaVirtualDisk 1</dev:code> <dev:remarks> <maml:para>Dismount the VHD file that is mounted as Disk 1 on the local host.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 10/6/2011 4:10 PM 21474836992 VM1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Mount-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Format-NaHostVolume</command:name> <maml:description> <maml:para>Perform a quick NTFS format on an existing Windows volume. Optionally, this can trigger a reclaim of any data previously held by the volume.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Format</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Perform a quick NTFS format on an existing Windows volume. Optionally, this can trigger a reclaim of any data previously held by the volume. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Format-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>Label</maml:name> <maml:description> <maml:para>The label to assign the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>AllocationUnitSize</maml:name> <maml:description> <maml:para>The allocation unit (cluster) size for the volume. Valid values are 4KB, 8KB, 16KB, 32KB, and 64KB</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks which formerly occupied the space used by the new volume. This option is only supported on Windows Vista sp1, Server 2008 or later.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Format-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>Label</maml:name> <maml:description> <maml:para>The label to assign the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "3" > <maml:name>AllocationUnitSize</maml:name> <maml:description> <maml:para>The allocation unit (cluster) size for the volume. Valid values are 4KB, 8KB, 16KB, 32KB, and 64KB</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks which formerly occupied the space used by the new volume. This option is only supported on Windows Vista sp1, Server 2008 or later.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Label</maml:name> <maml:description> <maml:para>The label to assign the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="3"> <maml:name>AllocationUnitSize</maml:name> <maml:description> <maml:para>The allocation unit (cluster) size for the volume. Valid values are 4KB, 8KB, 16KB, 32KB, and 64KB</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks which formerly occupied the space used by the new volume. This option is only supported on Windows Vista sp1, Server 2008 or later.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Format-NaHostVolume F:\</dev:code> <dev:remarks> <maml:para>Format the volume mounted at drive F:\ with default options.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Format-NaHostVolume "\\?\Volume{20a7fe7b-f8e4-11e0-949b-00155da1ce00}\" -Label "DB Logs" -Reclaim</dev:code> <dev:remarks> <maml:para>Format a volume by Guid path with a file system label. Reclaim any previously used space on the storage controller.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostDisk</command:name> <maml:description> <maml:para>Lists all disks on the local host that are served by Data ONTAP LUNs.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Lists all disks on the local host including (when available) information about the underlying Data ONTAP LUNs. This is useful for tracking which Data ONTAP controllers are serving storage to this host. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostDisk</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>DataOntap</maml:name> <maml:description> <maml:para>Get only disks stored on Data ONTAP LUNs.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Uninitialized</maml:name> <maml:description> <maml:para>Get only uninitialized (newly created, with no partition information or volumes) disks.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Disk</maml:name> <maml:description> <maml:para>Specify a Windows disk index to get details for a single disk. Otherwise all disks are listed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DataOntap</maml:name> <maml:description> <maml:para>Get only disks stored on Data ONTAP LUNs.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Uninitialized</maml:name> <maml:description> <maml:para>Get only uninitialized (newly created, with no partition information or volumes) disks.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Disk</maml:name> <maml:description> <maml:para>Specify a Windows disk index to get details for a single disk. Otherwise all disks are listed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.DiskResource</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostDisk -DataOntap</dev:code> <dev:remarks> <maml:para>List all disks on the local Windows host that are served by Data ONTAP LUNs.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Disk Size ControllerPath ---- ---- -------------- 1 50.0 GB benson:/vol/vol1/testlun 2 50.0 GB benson:/vol/vol1/testlun2 3 1.0 GB benson:/vol/vol1/lun3 4 20.0 GB dunn:/vol/vol2/lun2 5 20.0 GB dunn:/vol/vol2/lun1 6 49.9 GB dunn:/vol/opalis/opalisVM 7 20.0 GB dunn:/vol/vol2/lun5 9 50.0 GB dunn:/vol/opalis/w2k3OpalisVM 10 34.0 GB dunn:/vol/vol2/lun7b 11 20.0 GB dunn:/vol/vol2/lun6 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostDisk 1 | fl *</dev:code> <dev:remarks> <maml:para>List all details about disk 1.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>HostDiskName : \\.\PHYSICALDRIVE1 HostDiskWmiPath : \\X3550RRE7\root\cimv2:Win32_DiskDrive.DeviceID="\\\\.\\PHYSICALDRIVE1" HostDiskIndex : 1 DiskSerialNumber : HnT7cJYX0EIX DiskSize : 53694627840 ControllerName : benson ControllerIgroup : viaRPC.iqn.1991-05.com.microsoft:x3550rre7.rtprre.testdomain ControllerAddresses : {10.61.167.61} ControllerLunPath : /vol/vol1/testlun ControllerVolumeName : vol1 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>[wmi](Get-NaHostDisk 1).HostDiskWmiPath | fl *</dev:code> <dev:remarks> <maml:para>Get even more info from Windows Management Instrumentation (WMI) about disk 1.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>ConfigManagerErrorCode : 0 LastErrorCode : NeedsCleaning : Status : OK DeviceID : \\.\PHYSICALDRIVE1 StatusInfo : Partitions : 1 BytesPerSector : 512 ConfigManagerUserConfig : False DefaultBlockSize : Index : 1 InstallDate : InterfaceType : SCSI MaxBlockSize : MaxMediaSize : MinBlockSize : NumberOfMediaSupported : SectorsPerTrack : 63 Size : 53694627840 TotalCylinders : 6528 TotalHeads : 255 TotalSectors : 104872320 TotalTracks : 1664640 TracksPerCylinder : 255 __GENUS : 2 __CLASS : Win32_DiskDrive __SUPERCLASS : CIM_DiskDrive __DYNASTY : CIM_ManagedSystemElement __RELPATH : Win32_DiskDrive.DeviceID="\\\\.\\PHYSICALDRIVE1" __PROPERTY_COUNT : 51 __DERIVATION : {CIM_DiskDrive, CIM_MediaAccessDevice, CIM_LogicalDevice, CIM_LogicalElement...} __SERVER : X3550RRE7 __NAMESPACE : root\cimv2 __PATH : \\X3550RRE7\root\cimv2:Win32_DiskDrive.DeviceID="\\\\.\\PHYSICALDRIVE1" Availability : Capabilities : {3, 4} CapabilityDescriptions : {Random Access, Supports Writing} Caption : NETAPP LUN SCSI Disk Device CompressionMethod : CreationClassName : Win32_DiskDrive Description : Disk drive ErrorCleared : ErrorDescription : ErrorMethodology : FirmwareRevision : 7350 Manufacturer : (Standard disk drives) MediaLoaded : True MediaType : Fixed hard disk media Model : NETAPP LUN SCSI Disk Device Name : \\.\PHYSICALDRIVE1 PNPDeviceID : SCSI\DISK&VEN_NETAPP&PROD_LUN\1&1C121344&0&000200 PowerManagementCapabilities : PowerManagementSupported : SCSIBus : 0 SCSILogicalUnit : 0 SCSIPort : 3 SCSITargetId : 2 SerialNumber : HnT7cJYX0EIX Signature : 3201900809 SystemCreationClassName : Win32_ComputerSystem SystemName : X3550RRE7 Scope : System.Management.ManagementScope Path : \\X3550RRE7\root\cimv2:Win32_DiskDrive.DeviceID="\\\\.\\PHYSICALDRIVE1" Options : System.Management.ObjectGetOptions ClassPath : \\X3550RRE7\root\cimv2:Win32_DiskDrive Properties : {Availability, BytesPerSector, Capabilities, CapabilityDescriptions...} SystemProperties : {__GENUS, __CLASS, __SUPERCLASS, __DYNASTY...} Qualifiers : {dynamic, Locale, provider, UUID} Site : Container : </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 4 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostDisk -Uninitialized</dev:code> <dev:remarks> <maml:para>Get any uninitialized disks (with no partition information or volumes) on the system.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>HostDrivePath Disk Size ControllerPath ------------- ---- ---- -------------- 4 10.0 GB fas2040rre1:/vol/luns/test.lun </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHyperV</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Initialize-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostFcAdapter</command:name> <maml:description> <maml:para>Get FC adapters on the host machine.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostFcAdapter</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get FC adapters on the host machine.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostFcAdapter</maml:name> </command:syntaxItem> </command:syntax> <command:parameters> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.FcHbaInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostFcAdapter</dev:code> <dev:remarks> <maml:para>Get the FC adapters on the host machine.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostFcConnectivity</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostFcConnectivity</command:name> <maml:description> <maml:para>Get information about the host fibre channel connections to the current controller.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostFcConnectivity</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get information about the host fibre channel connections to the current controller.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostFcConnectivity</maml:name> <command:parameter required = "false" variableLength = "true" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>Wwnn</maml:name> <maml:description> <maml:para>The WWNN for which to check connectivity. If not specified, all WWNNs of the host fibre channel adapters will be checked.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "true" >String[]</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>Wwnn</maml:name> <maml:description> <maml:para>The WWNN for which to check connectivity. If not specified, all WWNNs of the host fibre channel adapters will be checked.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="true">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.Types.Fc.FcConnectivity</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host API: fcp-adapter-initiators-list-info</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostFcConnectivity</dev:code> <dev:remarks> <maml:para>Get the host fibre channel connectivity to the current controller.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Wwnn ConnectedTargets Wwpn Igroup ---- ---------------- ---- ------ 20:00:00:e0:8b:86:fc:9a {0b} 21:00:00:e0:8b:86:fc:9a {fujirx200rre3_4_fcp} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostFcAdapter</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostIscsiAdapter</command:name> <maml:description> <maml:para>Get information about the Microsoft iSCSI Initiator on the host machine.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostIscsiAdapter</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get information about the Microsoft iSCSI Initiator on the host machine.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostIscsiAdapter</maml:name> </command:syntaxItem> </command:syntax> <command:parameters> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiHbaInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiAdapter</dev:code> <dev:remarks> <maml:para>Get information about the Microsoft iSCSI Initiator on the host machine.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>InstanceName : Root\ISCSIPRT\0000_0 Vendor : Microsoft Corporation VendorModel : iSCSI Initiator SerialNumber : MSFT-05-1991 DriverName : msiscsi.sys FirmwareVersion : 1.5 Iqn : iqn.1991-05.com.microsoft:WIN2K8DEVRRE0 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostIscsiSession</command:name> <maml:description> <maml:para>Get current iSCSI sessions on the host machine.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostIscsiSession</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get current iSCSI sessions on the host machine.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostIscsiSession</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to get sessions for.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>TargetName</maml:name> <maml:description> <maml:para>The Iqn of the target to get sessions for.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiSessionInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiSession</dev:code> <dev:remarks> <maml:para>Get the current iSCSI sessions on the host machine.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Connections : {fffffa8003bb3018-0000000000000022} Devices : {\\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000000#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}, \\?\scs i#disk&ven_netapp&prod_lun#1&1c121344&0&000001#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}} NumConnections : 1 NumDevices : 2 SessionId : fffffa8003bb3018-4000013700000023 InitiatorName : iqn.1991-05.com.microsoft:win2k8devrre0 TargetName : iqn.1992-08.com.netapp:sn.135107386 Connections : {fffffa8003bb3018-0000000000000023} Devices : {\\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000100#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}} NumConnections : 1 NumDevices : 1 SessionId : fffffa8003bb3018-4000013700000024 InitiatorName : iqn.1991-05.com.microsoft:win2k8devrre0 TargetName : iqn.1992-08.com.netapp:sn.135107303 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiSession | Select -ExpandProperty devices</dev:code> <dev:remarks> <maml:para>Get the devices connected to the host machine.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>DeviceInterfaceGuid : 53f56307-b6bf-11d0-94f20a0c91efb8b DeviceInterfaceName : \\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000000#{53f56307-b6bf-11d0-94f2-00a0c91efb8b} DeviceNumber : 1 DeviceType : 7 InitiatorName : Root\ISCSIPRT\0000_0 LegacyName : \\.\PhysicalDrive1 PartitionNumber : 0 ScsiLun : 0 ScsiPathId : 0 ScsiPortNumber : 3 ScsiTargetId : 0 TargetName : iqn.1992-08.com.netapp:sn.135107386 DeviceInterfaceGuid : 53f56307-b6bf-11d0-94f20a0c91efb8b DeviceInterfaceName : \\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000001#{53f56307-b6bf-11d0-94f2-00a0c91efb8b} DeviceNumber : 2 DeviceType : 7 InitiatorName : Root\ISCSIPRT\0000_0 LegacyName : \\.\PhysicalDrive2 PartitionNumber : 0 ScsiLun : 1 ScsiPathId : 0 ScsiPortNumber : 3 ScsiTargetId : 0 TargetName : iqn.1992-08.com.netapp:sn.135107386 DeviceInterfaceGuid : 53f56307-b6bf-11d0-94f20a0c91efb8b DeviceInterfaceName : \\?\scsi#disk&ven_netapp&prod_lun#1&1c121344&0&000100#{53f56307-b6bf-11d0-94f2-00a0c91efb8b} DeviceNumber : 3 DeviceType : 7 InitiatorName : Root\ISCSIPRT\0000_0 LegacyName : \\.\PhysicalDrive3 PartitionNumber : 0 ScsiLun : 0 ScsiPathId : 0 ScsiPortNumber : 3 ScsiTargetId : 1 TargetName : iqn.1992-08.com.netapp:sn.135107303 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiSession -TargetName iqn.1992-08.com.netapp:sn.99927627 | select -ExpandProperty Connections</dev:code> <dev:remarks> <maml:para>Get a list of connections to the given target.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>ConnectionId : fffffa8003fb9018-0000000000000034 InitiatorAddress : 192.168.0.100 InitiatorPort : 64465 TargetAddress : 192.168.0.102 TargetPort : 3260 ConnectionId : fffffa8003fb9018-0000000000000035 InitiatorAddress : 192.168.0.100 InitiatorPort : 12754 TargetAddress : 192.168.0.102 TargetPort : 3260 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostIscsiTarget</command:name> <maml:description> <maml:para>Get the targets discovered by the iSCSI Initiator.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostIscsiTarget</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get the targets discovered by the iSCSI Initiator.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostIscsiTarget</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "named" > <maml:name>IpAddress</maml:name> <maml:description> <maml:para>Ip Address of a target portal used to discover this target. If omitted, all discovered targets are retrieved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "named" > <maml:name>Port</maml:name> <maml:description> <maml:para>The port that was used to discover this target. Default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "1" > <maml:name>TargetName</maml:name> <maml:description> <maml:para>The name of the target to get. If omitted, all targets are returned.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>IpAddress</maml:name> <maml:description> <maml:para>Ip Address of a target portal used to discover this target. If omitted, all discovered targets are retrieved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Port</maml:name> <maml:description> <maml:para>The port that was used to discover this target. Default is 3260.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="1"> <maml:name>TargetName</maml:name> <maml:description> <maml:para>The name of the target to get. If omitted, all targets are returned.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiTargetInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiTarget</dev:code> <dev:remarks> <maml:para>Get the targets that have been discovered by the iSCSI Initiator.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>DiscoveryMechanism : SendTargets:*10.61.169.28 0003260 Root\ISCSIPRT\0000_0 InitiatorName : Root\ISCSIPRT\0000_0 TargetName : iqn.1992-08.com.netapp:sn.135107386 IsConnected : True DiscoveryMechanism : SendTargets:*10.61.169.29 0003260 Root\ISCSIPRT\0000_0 InitiatorName : Root\ISCSIPRT\0000_0 TargetName : iqn.1992-08.com.netapp:sn.135107303 IsConnected : True </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostIscsiTarget 10.61.169.29</dev:code> <dev:remarks> <maml:para>Get the targets discovered on 10.61.169.29.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>DiscoveryMechanism : SendTargets:*10.61.169.29 0003260 Root\ISCSIPRT\0000_0 InitiatorName : Root\ISCSIPRT\0000_0 TargetName : iqn.1992-08.com.netapp:sn.135107303 IsConnected : True </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Connect-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Disconnect-NaHostIscsiTarget</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHostVolume</command:name> <maml:description> <maml:para>Get Windows volume information.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get Windows volume information. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHostVolume</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostVolume</dev:code> <dev:remarks> <maml:para>Get all Windows volumes.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {} 0 100.0 MB {\\?\Volume{6c208c1f-2a50-11e0-9070-806e6f6e6963}\} {C:\} 0 49.9 GB {\\?\Volume{6c208c20-2a50-11e0-9070-806e6f6e6963}\} {S:\} 2 5.0 GB {\\?\Volume{24385e54-d340-11e0-ad95-00155da1ce00}\, \\?\Volume{f4db2c... {E:\} 4 10.0 GB {\\?\Volume{20a7fb8e-f8e4-11e0-949b-00155da1ce00}\} {F:\} 5 1021.0 MB {\\?\Volume{20a7fe7b-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostVolume -DiskIndex 0</dev:code> <dev:remarks> <maml:para>Get all volumes located on disk 0.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {} 0 100.0 MB {\\?\Volume{6c208c1f-2a50-11e0-9070-806e6f6e6963}\} {C:\} 0 49.9 GB {\\?\Volume{6c208c20-2a50-11e0-9070-806e6f6e6963}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostVolume C:\</dev:code> <dev:remarks> <maml:para>Get a specific volume by drive letter.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {C:\} 0 49.9 GB {\\?\Volume{6c208c20-2a50-11e0-9070-806e6f6e6963}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 4 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostVolume "\\?\Volume{6c208c20-2a50-11e0-9070-806e6f6e6963}\"</dev:code> <dev:remarks> <maml:para>Get a volume by volume guid path</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {C:\} 0 49.9 GB {\\?\Volume{6c208c20-2a50-11e0-9070-806e6f6e6963}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaHostVolumeSize</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Mount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Dismount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaHyperV</command:name> <maml:description> <maml:para>List Hyper-V virtual machines running on the local host along with all Data ONTAP storage resources that they are using.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaHyperV</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>List Hyper-V virtual machines running on the local host along with all Data ONTAP storage resources that they are using.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaHyperV</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Name</maml:name> <maml:description> <maml:para>The name of one or more virtual machines to get. Wildcards are permitted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>All</maml:name> <maml:description> <maml:para>Specify to return all virtual machines, not just ones utilizing Data ONTAP storage.</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Name</maml:name> <maml:description> <maml:para>The name of one or more virtual machines to get. Wildcards are permitted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Specify to return all virtual machines, not just ones utilizing Data ONTAP storage.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.VirtualMachine</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHyperV | ft -AutoSize</dev:code> <dev:remarks> <maml:para>List all Hyper-V virtual machines running on the local host that utilize Data ONTAP storage resources.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Name Guid Storage ---- ---- ------- OpalisVM 68073F14-5B9A-44F2-923F-766432BE9A68 {O:\OpalisVM.vhd} W2k3OpalisVM F4043F56-79A1-4FA3-8F71-77E2CEBCF0E7 {P:\W2k3OpalisVM.vhd} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>(Get-NaHyperV OpalisVM).Storage</dev:code> <dev:remarks> <maml:para>List the Data ONTAP storage resource(s) on Hyper-V virtual machine 'OpalisVM'.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>VmDiskResourceName : O:\OpalisVM.vhd VmDiskResourceType : VHD HostDrivePath : O:\ HostDiskName : \\.\PHYSICALDRIVE3 HostVolume : \\?\Volume{4044589b-4fd9-4c90-8495-f430945e7439}\ HostVolumeIsCsv : False ControllerName : dunn ControllerIgroup : viaRPC.iqn.1991-05.com.microsoft:x3550rre7.rtprre.testdomain ControllerAddress : 10.61.167.60 ControllerLunPath : /vol/opalis/opalisVM ControllerVolumeName : opalis </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaVirtualDiskAlignment</command:name> <maml:description> <maml:para>Get the disk partitions of the given Virtual Hard Disk and determine if they are aligned.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaVirtualDiskAlignment</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get the disk partitions of the given Virtual Hard Disk and determine if they are aligned. VHD and VHDX format disks are supported. The virtual disk must be an MBR disk. Virtual disks inside a Data ONTAP volume not visible to the host are supported (accessed using a /vol/<volname>/<path> path).</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaVirtualDiskAlignment</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>VirtualDisk</maml:name> <maml:description> <maml:para>Path to the virtual hard disk. This can be a fully-qualified Windows path or a path to a file inside a Data ONTAP volume (/vol/<volname>/<path>). If the path is to a file inside a Data ONTAP volume an NaController must be specified using the Controller parameter or must be present in $global:CurrentNaController.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>VirtualDisk</maml:name> <maml:description> <maml:para>Path to the virtual hard disk. This can be a fully-qualified Windows path or a path to a file inside a Data ONTAP volume (/vol/<volname>/<path>). If the path is to a file inside a Data ONTAP volume an NaController must be specified using the Controller parameter or must be present in $global:CurrentNaController.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.HyperV.MbrPartition</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVirtualDiskAlignment E:\misaligned.vhd</dev:code> <dev:remarks> <maml:para>Get the alignment information of the partitions contained in the virtual disk.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>VirtualDisk: E:\misaligned.vhd IsBootable AbsoluteStartingLba Size IsEbr IsAligned ---------- ------------------- ---- ----- --------- False 63 14680064 False False </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVirtualDiskAlignment /vol/vol4/VHDs/w7.vhd</dev:code> <dev:remarks> <maml:para>Get the alignment of the VHD file on the controller.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>VirtualDisk: /vol/vol4/VHDs/w7.vhd IsBootable AbsoluteStartingLba Size IsEbr IsAligned ---------- ------------------- ---- ----- --------- True 2048 204800 False True False 206848 58511360 False True </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVirtualDiskAlignment C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx</dev:code> <dev:remarks> <maml:para>Get the alignment of a VHDX virtual disk.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>VirtualDisk: C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx IsBootable AbsoluteStartingLba Size IsExtendedBootRecord IsAligned ---------- ------------------- ---- -------------------- --------- True 63 20 GB False False </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Repair-NaVirtualDiskAlignment</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaVssProvider</command:name> <maml:description> <maml:para>Get a list of all VSS providers on the current system.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaVssProvider</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get a list of all VSS providers on the current system.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaVssProvider</maml:name> </command:syntaxItem> </command:syntax> <command:parameters> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.Vss.VssProviderProperties</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: vss</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVssProvider</dev:code> <dev:remarks> <maml:para>Get a list of all providers on the current system.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>ProviderId : b5946137-7b9f-4925-af80-51abd60b20d5 ProviderName : Microsoft Software Shadow Copy provider 1.0 ProviderType : SYSTEM ProviderVersion : 1.0.0.7 ProviderVersionId : 00000001-0000-0000-0007-000000000001 ClassId : 65ee1dba-8ff4-4a58-ac1c-3470ee2f376a </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaVssSnapshot</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaVssWriter</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaVssSnapshot</command:name> <maml:description> <maml:para>Get a list of completed shadow copies in the system that reside in the given context.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaVssSnapshot</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get a list of completed shadow copies in the system that reside in the given context.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaVssSnapshot</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>Context</maml:name> <maml:description> <maml:para>The VSS_SNAPSHOT_CONTEXT to query snapshots. Only snapshots with this context will be returned. Default value is BACKUP. Possible values: ALL, BACKUP, FILE_SHARE_BACKUP, NAS_ROLLBACK, APP_ROLLBACK, CLIENT_ACCESSIBLE, CLIENT_ACCESSIBLE_WRITERS.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VSS_SNAPSHOT_CONTEXT</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>Context</maml:name> <maml:description> <maml:para>The VSS_SNAPSHOT_CONTEXT to query snapshots. Only snapshots with this context will be returned. Default value is BACKUP. Possible values: ALL, BACKUP, FILE_SHARE_BACKUP, NAS_ROLLBACK, APP_ROLLBACK, CLIENT_ACCESSIBLE, CLIENT_ACCESSIBLE_WRITERS.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">VSS_SNAPSHOT_CONTEXT</command:parameterValue> <dev:type> <maml:name>VSS_SNAPSHOT_CONTEXT</maml:name> <maml:uri/> </dev:type> <dev:defaultValue>BACKUP</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.Vss.VssSnapshotProperties</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: vss</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVssSnapshot APP_ROLLBACK</dev:code> <dev:remarks> <maml:para>Get all of the completed VSS shadow copies in the APP_ROLLBACK snapshot context.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>SnapshotId : ce7bb1f0-a849-4f08-a319-f65d153303d7 SnapshotSetId : f4eebe60-7ba4-4cde-9392-d9068aae30b5 SnapshotsCount : 1 SnapshotDeviceObject : \\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy30 OriginalVolumeName : \\?\Volume{692eb055-7495-4360-b64c-5d3eee11a15a}\ OriginatingMachine : WIN2K8DEVRRE0.rtprre.testdomain ServiceMachine : WIN2K8DEVRRE0.rtprre.testdomain ExposedName : ExposedPath : ProviderId : b5946137-7b9f-4925-af80-51abd60b20d5 SnapshotAttributes : 131081 CreationTimestamp : 129985997207704906 Status : CREATED </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaVssProvider</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaVssWriter</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Get-NaVssWriter</command:name> <maml:description> <maml:para>Get a list of available VSS writers on the current system.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Get</command:verb> <command:noun>NaVssWriter</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Get a list of available VSS writers on the current system.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-NaVssWriter</maml:name> </command:syntaxItem> </command:syntax> <command:parameters> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.Vss.VssWriter</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>category: vss</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaVssWriter</dev:code> <dev:remarks> <maml:para>Get a list of available VSS writers on the current system.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Name WriterId WriterInstanceId State ---- -------- ---------------- ----- Task Scheduler Writer d61d61c8-d73a-4eee-8cdd-f6f9786b7124 1bddd48e-5052-49db-9b07-b96f96727e6b STABLE VSS Metadata Store Writer 75dfb225-e2e4-4d39-9ac9-ffaff65ddf06 088e7a7d-09a8-4cc6-a609-ad90e75ddc93 STABLE Performance Counters Writer 0bada1de-01a9-4625-8278-69e735f39dd2 f0086dda-9efc-47c5-8eb6-a944c3d09381 STABLE ASR Writer be000cbe-11fe-4426-9c58-531aa6355fc4 32457a2b-07fb-4b14-8741-01e35e632060 STABLE SqlServerWriter a65faa63-5ea8-4ebc-9dbd-a0c4db26912a 967e2b4d-c711-496f-be80-0e7c326a31d5 STABLE WMI Writer a6ad56c2-b509-4e6c-bb19-49d8f43532f0 9441b829-3997-477b-924a-d7214e3e0335 STABLE BITS Writer 4969d978-be47-48b0-b100-f328f07ac1e0 aaab528d-9f49-434b-b414-0e43a4433089 STABLE IIS Config Writer 2a40fd15-dfca-4aa8-a654-1f8c654603f6 bb090708-fe61-45dd-90f9-4f6df8425199 STABLE Registry Writer afbab4a2-367d-4d15-a586-71dbb18f8485 4b56ea12-d805-4767-814e-6c4f86905b28 STABLE COM+ REGDB Writer 542da469-d3e1-473c-9f4f-7847f01fc64f 36dc29f5-6f07-4901-a8e4-2be0d258cf09 STABLE Shadow Copy Optimization Writer 4dc3bdd4-ab48-4d07-adb0-3bee2926fd7f bff08e91-9a7c-4228-8312-c6ce45cecee2 STABLE </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaVssProvider</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaVssSnapshot</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Initialize-NaHostDisk</command:name> <maml:description> <maml:para>Initialize a Windows disk with basic partition layout information.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Initialize</command:verb> <command:noun>NaHostDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Initialize a Windows disk with basic partition layout information. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Initialize-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>PartitionStyle</maml:name> <maml:description> <maml:para>Partition style (Gpt or Mbr)</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >PartitionStyle</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>PartitionStyle</maml:name> <maml:description> <maml:para>Partition style (Gpt or Mbr)</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">PartitionStyle</command:parameterValue> <dev:type> <maml:name>PartitionStyle</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.DiskResource</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Initialize-NaHostDisk 4 -PartitionStyle Gpt</dev:code> <dev:remarks> <maml:para>Initialize a host disk by disk number.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHostDisk -Uninitialized | Initialize-NaHostDisk</dev:code> <dev:remarks> <maml:para>Initialize all uninitialized host disks.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Invoke-NaHostVolumeSpaceReclaim</command:name> <maml:description> <maml:para>Reclaim free space on a Windows volume that is hosted on a Data ONTAP LUN.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Invoke</command:verb> <command:noun>NaHostVolumeSpaceReclaim</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Reclaim free space on a Windows volume that is hosted on a Data ONTAP LUN. This cmdlet examines the NTFS file system on a Windows volume, locates all free space, and deallocates the corresponding blocks on the Data ONTAP storage controller. No difference is apparent from Windows' perspective, but all space not consumed by files on the volume is freed on the storage controller. Cluster-shared volumes (CSVs) are supported, but this cmdlet uses a different reclamation algorithm due to CSV limitations. A CSV may appear to become up to 98% full during the reclamation process, but this should not pose a problem even for LUNs that are not space-reserved. There is no requirement for the CSV to be in redirected or maintenance mode to use this cmdlet. This cmdlet may be run while the Windows volume is online and undergoing active I/O. Administrator privileges are required to use this cmdlet.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Invoke-NaHostVolumeSpaceReclaim</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Invoke-NaHostVolumeSpaceReclaim</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Invoke-NaHostVolumeSpaceReclaim f:</dev:code> <dev:remarks> <maml:para>Reclaim all free space on the LUN mounted as F:\ on the local host.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Invoke-NaVirtualDiskSpaceReclaim</command:name> <maml:description> <maml:para>Reclaim space on a virtual disk residing on a Data ONTAP LUN.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Invoke</command:verb> <command:noun>NaVirtualDiskSpaceReclaim</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Reclaim space on a virtual disk residing on a Data ONTAP LUN. This cmdlet works by mounting a copy of the virtual disk to the host and finding the free space in the NTFS filesystem. The corresponding blocks in the original virtual disk are then freed on the Data ONTAP controller. This cmdlet requires the virtual disk to be experiencing no active I/O. Taking a Hyper-V snapshot of a running virtual machine before invoking this cmdlet allows space to be reclaimed on a running virtual machine. After the cmdlet has completed, the Hyper-V snapshot can be deleted.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Invoke-NaVirtualDiskSpaceReclaim</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>Name</maml:name> <maml:description> <maml:para>Full path to the virtual disk. This can be a VHD or VHDX file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>Controller containing the virtual disk file embodied by a NaController or NcController object. This is obtained using Connect-NaController or Connect-NcController. If not provided, the values in the global variables CurrentNaController and CurrentNcController are considered. If neither contain the virtual disk file, an attempt is made to establish a connection to the controller containing the file. If no connection can be established, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>Name</maml:name> <maml:description> <maml:para>Full path to the virtual disk. This can be a VHD or VHDX file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>Controller containing the virtual disk file embodied by a NaController or NcController object. This is obtained using Connect-NaController or Connect-NcController. If not provided, the values in the global variables CurrentNaController and CurrentNcController are considered. If neither contain the virtual disk file, an attempt is made to establish a connection to the controller containing the file. If no connection can be established, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Invoke-NaVirtualDiskSpaceReclaim -Name E:\vm0_disk0.vhd</dev:code> <dev:remarks> <maml:para>Reclaim all space from the virtual disk vm0_disk0. The virtual machine using this disk is offline.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Get-NaHyperV Win2k8R2_VM1 | Checkpoint-VM -SnapshotName reclaim_snapshot Invoke-NaVirtualDiskSpaceReclaim -Name C:\ClusterStorage\Volume2\VirtualDisks\Win2k8R2_VM1.vhdx Remove-VMSnapshot -Name reclaim_snapshot -VMName Win2K8R2_VM1</dev:code> <dev:remarks> <maml:para>Take a snapshot of a running virtual machine, reclaim the free space, then remove the snapshot.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHyperV</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Invoke-NaVssBackup</command:name> <maml:description> <maml:para>Create a VSS shadow copy snapshot set for the given volumes.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Invoke</command:verb> <command:noun>NaVssBackup</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Create a VSS shadow copy snapshot set for the given volumes.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Invoke-NaVssBackup</maml:name> <command:parameter required = "true" variableLength = "true" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>Volume</maml:name> <maml:description> <maml:para>One or more volumes to include in the shadow copy snapshot set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "true" >String[]</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "true" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>IncludeWriter</maml:name> <maml:description> <maml:para>A list of writers to explicitly include in the operation. If not specified, all writers will be implicitly included.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "true" >Guid[]</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "true" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>ExcludeWriter</maml:name> <maml:description> <maml:para>A list of writers to explicitly exclude from the operation.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "true" >Guid[]</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>Provider</maml:name> <maml:description> <maml:para>Provider to use when performing the snapshot operation. If not specified, the default provider will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>BackupType</maml:name> <maml:description> <maml:para>The type of backup to perform. Default is FULL. Possible values: FULL, INCREMENTAL, DIFFERENTIAL, LOG, COPY.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VSS_BACKUP_TYPE</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SnapshotContext</maml:name> <maml:description> <maml:para>Snapshot context to perform the backup. If not specified, APP_ROLLBACK will be used. Possible values: ALL, BACKUP, FILE_SHARE_BACKUP, NAS_ROLLBACK, APP_ROLLBACK, CLIENT_ACCESSIBLE, CLIENT_ACCESSIBLE_WRITERS.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >VSS_SNAPSHOT_CONTEXT</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>Volume</maml:name> <maml:description> <maml:para>One or more volumes to include in the shadow copy snapshot set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="true">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>IncludeWriter</maml:name> <maml:description> <maml:para>A list of writers to explicitly include in the operation. If not specified, all writers will be implicitly included.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="true">Guid[]</command:parameterValue> <dev:type> <maml:name>Guid[]</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>ExcludeWriter</maml:name> <maml:description> <maml:para>A list of writers to explicitly exclude from the operation.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="true">Guid[]</command:parameterValue> <dev:type> <maml:name>Guid[]</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>Provider</maml:name> <maml:description> <maml:para>Provider to use when performing the snapshot operation. If not specified, the default provider will be used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>BackupType</maml:name> <maml:description> <maml:para>The type of backup to perform. Default is FULL. Possible values: FULL, INCREMENTAL, DIFFERENTIAL, LOG, COPY.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">VSS_BACKUP_TYPE</command:parameterValue> <dev:type> <maml:name>VSS_BACKUP_TYPE</maml:name> <maml:uri/> </dev:type> <dev:defaultValue>FULL</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SnapshotContext</maml:name> <maml:description> <maml:para>Snapshot context to perform the backup. If not specified, APP_ROLLBACK will be used. Possible values: ALL, BACKUP, FILE_SHARE_BACKUP, NAS_ROLLBACK, APP_ROLLBACK, CLIENT_ACCESSIBLE, CLIENT_ACCESSIBLE_WRITERS.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">VSS_SNAPSHOT_CONTEXT</command:parameterValue> <dev:type> <maml:name>VSS_SNAPSHOT_CONTEXT</maml:name> <maml:uri/> </dev:type> <dev:defaultValue>APP_ROLLBACK</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>category: vss</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Invoke-NaVssBackup -Volume E:\</dev:code> <dev:remarks> <maml:para>Create a shadow copy snapshot set containing the volume E:\ involving all of the available writers.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaVssWriter</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaVssProvider</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaVssSnapshot</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Mount-NaHostVolume</command:name> <maml:description> <maml:para>Add a drive letter or empty folder mount point to an existing Windows volume.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Mount</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Add a drive letter or empty folder mount point to an existing Windows volume. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Mount-NaHostVolume</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>MountPoint</maml:name> <maml:description> <maml:para>A drive letter (i.e. 'G') or the path to an empty folder to mount the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Mount-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>MountPoint</maml:name> <maml:description> <maml:para>A drive letter (i.e. 'G') or the path to an empty folder to mount the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="2"> <maml:name>MountPoint</maml:name> <maml:description> <maml:para>A drive letter (i.e. 'G') or the path to an empty folder to mount the volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Mount-NaHostVolume E:\ -MountPoint C:\NewDir</dev:code> <dev:remarks> <maml:para>Add a folder mount point to the volume currently mounted at E:\.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {E:\, C:\NewDir\} 4 10.0 GB {\\?\Volume{20a7fedf-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Dismount-NaHostVolume Q:\ | Mount-NaHostVolume -MountPoint E:\</dev:code> <dev:remarks> <maml:para>Change the drive letter of a volume.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {E:\} 4 10.0 GB {\\?\Volume{20a7fedf-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Dismount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaHostVolumeSize</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Mount-NaVirtualDisk</command:name> <maml:description> <maml:para>Mounts a VHD file on the local host.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Mount</command:verb> <command:noun>NaVirtualDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Mounts a VHD file on the local host. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Mount-NaVirtualDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified path of the VHD file to be mounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified path of the VHD file to be mounted.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.DiskResource</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Mount-NaVirtualDisk G:\VM1.vhd</dev:code> <dev:remarks> <maml:para>Mount the VHD file 'G:\VM1.vhd' as a disk on the local host.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 10/6/2011 4:10 PM 21474836992 VM1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Dismount-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Initialize-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>New-NaHostVolume</command:name> <maml:description> <maml:para>Create a new Windows volume on an existing disk.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>New</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Create a new Windows volume on an existing disk. This will automatically initialize an unitialized/offline disk and optionally format the new volume (by default) This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>New-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>MountPoint</maml:name> <maml:description> <maml:para>A drive letter (i.e. 'G') or the path to an empty folder to mount the new volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>NoMount</maml:name> <maml:description> <maml:para>Do not automatically assign a drive letter</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Raw</maml:name> <maml:description> <maml:para>Do not format the new volume, leave it as a raw partition</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Label</maml:name> <maml:description> <maml:para>The label to assign the new file system</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Size</maml:name> <maml:description> <maml:para>The size in bytes of the new volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>AllocationUnitSize</maml:name> <maml:description> <maml:para>The allocation unit (cluster) size for the volume. Valid values are 4KB, 8KB, 16KB, 32KB, and 64KB</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks which formerly occupied the space used by the new volume</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="2"> <maml:name>MountPoint</maml:name> <maml:description> <maml:para>A drive letter (i.e. 'G') or the path to an empty folder to mount the new volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoMount</maml:name> <maml:description> <maml:para>Do not automatically assign a drive letter</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Raw</maml:name> <maml:description> <maml:para>Do not format the new volume, leave it as a raw partition</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Label</maml:name> <maml:description> <maml:para>The label to assign the new file system</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Size</maml:name> <maml:description> <maml:para>The size in bytes of the new volume</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>AllocationUnitSize</maml:name> <maml:description> <maml:para>The allocation unit (cluster) size for the volume. Valid values are 4KB, 8KB, 16KB, 32KB, and 64KB</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks which formerly occupied the space used by the new volume</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>New-NaHostVolume 4</dev:code> <dev:remarks> <maml:para>Create a new volume on disk 4</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {E:\} 4 10.0 GB {\\?\Volume{20a7fedf-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>New-NaHostVolume 4 -Raw</dev:code> <dev:remarks> <maml:para>Create a new raw (unformatted) volume</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {} 4 10.0 GB {\\?\Volume{20a8008a-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 3 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>New-NaHostVolume 4 J:\</dev:code> <dev:remarks> <maml:para>Create a new volume with a specific mount point</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {J:\} 4 10.0 GB {\\?\Volume{20a8008a-f8e4-11e0-949b-00155da1ce00}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaHostVolumeSize</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Mount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Dismount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>New-NaVirtualDisk</command:name> <maml:description> <maml:para>Rapidly create a VHD file on a LUN or CIFS share mounted on a Windows host.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>New</command:verb> <command:noun>NaVirtualDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Rapidly create a VHD file on a LUN or CIFS share mounted on a Windows host. This cmdlet creates a VHD file between 12 MB and 2040 GB in size. Smaller files are created nearly instantly, while the largest ones typically finish in seconds or minutes. The file blocks are zeroed on the Data ONTAP storage controller using block deallocation, so the VHD file consumes no space until data is written to it. This cmdlet can also create a VHDX file between 12MB and 64TB in size. By default the cmdlet will deallocate blocks on the Data ONTAP storage controller, but the -Dynamic switch allows the creation of dynamic VHDX files which will remain block-aligned as they grow. The file to be created must be specified with a fully-qualified path that resides on a Data ONTAP LUN. Cluster-shared volumes (CSVs) are supported. Administrator privileges are required to use this cmdlet. In order to create a file on a CIFS share, a connection to the Data ONTAP controller must be made. If the Controller parameter is not specified and the global CurrentNaController variable is not present, the cmdlet consults the credentials cache to attempt to make a connection. If a connection cannot be made, the cmdlet will fail.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>New-NaVirtualDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "2" > <maml:name>Size</maml:name> <maml:description> <maml:para>Size in bytes of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>In order to create a file on a CIFS share, a connection to the Data ONTAP controller hosting the CIFS share must be made. This parameter is returned by the Connect-NaController or Connect-NcController cmdlet. If not present, the value in the global variable CurrentNaController or CurrentNcController will be used. If no global variables are present, the cmdlet consults the credentials cache and attempts to make a connection. If no connection can be made, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>New-NaVirtualDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "2" > <maml:name>Size</maml:name> <maml:description> <maml:para>Size in bytes of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Vhdx</maml:name> <maml:description> <maml:para>If specified, the cmdlet will create a VHDX file.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Dynamic</maml:name> <maml:description> <maml:para>If specified, create a dynamic VHDX file.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "3" > <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>In order to create a file on a CIFS share, a connection to the Data ONTAP controller hosting the CIFS share must be made. This parameter is returned by the Connect-NaController or Connect-NcController cmdlet. If not present, the value in the global variable CurrentNaController or CurrentNcController will be used. If no global variables are present, the cmdlet consults the credentials cache and attempts to make a connection. If no connection can be made, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="2"> <maml:name>Size</maml:name> <maml:description> <maml:para>Size in bytes of the VHD file to be created.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>In order to create a file on a CIFS share, a connection to the Data ONTAP controller hosting the CIFS share must be made. This parameter is returned by the Connect-NaController or Connect-NcController cmdlet. If not present, the value in the global variable CurrentNaController or CurrentNcController will be used. If no global variables are present, the cmdlet consults the credentials cache and attempts to make a connection. If no connection can be made, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Vhdx</maml:name> <maml:description> <maml:para>If specified, the cmdlet will create a VHDX file.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Dynamic</maml:name> <maml:description> <maml:para>If specified, create a dynamic VHDX file.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="3"> <maml:name>BlockSize</maml:name> <maml:description> <maml:para>The block size to assign the created VHDX file. The block size defines the size of each payload chunk inside the VHDX. The block size must be a power of 2 and at least 1 MB and at most 256 MB.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>New-NaVirtualDisk j:\vm1.vhd (1tb)</dev:code> <dev:remarks> <maml:para>Create a 1TB VHD file on the J: drive.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 7/22/2011 1:27 PM 1099511624192 vm1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Set-NaVirtualDiskSize</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Remove-NaHostFile</command:name> <maml:description> <maml:para>Delete a file, completely reclaiming all of the space it consumed on the storage controller.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Remove</command:verb> <command:noun>NaHostFile</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Delete a file, completely reclaiming all of the space it consumed on the storage controller. The file to be deleted must be specified with a fully-qualified path that resides on a Data ONTAP LUN or Data ONTAP CIFS share. Cluster-shared volumes (CSVs) are supported. Administrator privileges may be required to use this cmdlet.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Remove-NaHostFile</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>Full path to the file to remove.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>FullName</maml:name> <maml:description> <maml:para>Full path to the file to remove.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Remove-NaHostFile j:\test.vhd</dev:code> <dev:remarks> <maml:para>Delete the file 'j:\test.vhd' after reclaiming all of the space it consumed on the storage controller.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Remove-NaHostIscsiConnection</command:name> <maml:description> <maml:para>Remove a connection from an iSCSI session.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Remove</command:verb> <command:noun>NaHostIscsiConnection</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Remove a connection from an iSCSI session.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Remove-NaHostIscsiConnection</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID from which to remove connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>ConnectionId</maml:name> <maml:description> <maml:para>Connection ID to remove.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>SessionId</maml:name> <maml:description> <maml:para>Session ID from which to remove connection.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="2"> <maml:name>ConnectionId</maml:name> <maml:description> <maml:para>Connection ID to remove.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.IscsiSessionInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Remove-NaHostIscsiConnection -ConnectionId fffffa800a2d7428-000000000000623c -SessionId fffffa800a2d7428-4000013700000056</dev:code> <dev:remarks> <maml:para>Remove the given connection from the given session.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>SessionId TargetName NumConnections NumDevices --------- ---------- -------------- ---------- fffffa800a2d7428-4000013700000056 iqn.1992-08.com.netapp:sn.149c3db9b3c... 2 0 </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Add-NaHostIscsiConnection</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Remove-NaHostVolume</command:name> <maml:description> <maml:para>Remove a Windows volume from a disk.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Remove</command:verb> <command:noun>NaHostVolume</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Remove a Windows volume from a disk. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Remove-NaHostVolume</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks formerly occupied by the volume</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Remove-NaHostVolume</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks formerly occupied by the volume</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Reclaim</maml:name> <maml:description> <maml:para>Free any blocks formerly occupied by the volume</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Force</maml:name> <maml:description> <maml:para>Continue even if volume is in use. This might cause unexpected errors in any application using this volume.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Remove-NaHostVolume J:\</dev:code> <dev:remarks> <maml:para>Remove the J:\ volume from its parent disk.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Format-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Repair-NaVirtualDiskAlignment</command:name> <maml:description> <maml:para>Perform an alignment operation on a misaligned virtual hard disk file. If the virtual hard disk file contains only aligned partitions the cmdlet will do nothing.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Repair</command:verb> <command:noun>NaVirtualDiskAlignment</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Perform an alignment operation on a misaligned virtual hard disk file. If the virtual hard disk file contains only aligned partitions the cmdlet will do nothing. This cmdlet can align VHD and VHDX format virtual disks. The virtual disk must be an MBR disk residing on a Data ONTAP LUN or Data ONTAP CIFS share. Virtual disks inside a Data ONTAP volume not visible to the host are supported (accessed using a /vol/<volname>/<path> path). When possible, the cmdlet will use Data ONTAP to offload the alignment operation. The cmdlet will prompt for confirmation when a host-based copy is going to be used. The switch, ForceHostCopy, can be used to force the cmdlet to use a host-based copy. A host-based copy will use SCSI XCOPY when available, otherwise data will be copied from the source to the host, then from the host to the destination. If the virtual hard disk file contains partitions that are already aligned, a cloning operation will be used to move the partition into the aligned virtual disk. The ForceHostCopy switch disables this behavior. The cmdlet backs up the virtual hard disk file with the original name plus the extension ".bkup"</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Repair-NaVirtualDiskAlignment</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>VirtualDisk</maml:name> <maml:description> <maml:para>Path to the virtual hard disk. This can be a fully-qualified Windows path or a path to a file inside a Data ONTAP volume (/vol/<volname>/<path>). If the path is to a file inside a Data ONTAP volume an NaController must be specified using the Controller parameter or must be present in $global:CurrentNaController.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>ForceHostCopy</maml:name> <maml:description> <maml:para>If specified, the cmdlet will use a host based copy operation to perform the alignment. A host-based copy will use SCSI XCOPY when available, otherwise data will be copied from the source to the host, then from the host to the destination.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>VirtualDisk</maml:name> <maml:description> <maml:para>Path to the virtual hard disk. This can be a fully-qualified Windows path or a path to a file inside a Data ONTAP volume (/vol/<volname>/<path>). If the path is to a file inside a Data ONTAP volume an NaController must be specified using the Controller parameter or must be present in $global:CurrentNaController.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceHostCopy</maml:name> <maml:description> <maml:para>If specified, the cmdlet will use a host based copy operation to perform the alignment. A host-based copy will use SCSI XCOPY when available, otherwise data will be copied from the source to the host, then from the host to the destination.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Repair-NaVirtualDiskAlignment E:\misaligned.vhd</dev:code> <dev:remarks> <maml:para>Align the partitions for the virtual hard disk file.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 1/5/2012 12:21 PM 10737418752 misaligned.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Repair-NaVirtualDiskAlignment C:\ClusterStorage\Volume2\VirtualDisks\Win2k3_VM1\win2k3-boot.vhdx</dev:code> <dev:remarks> <maml:para>Align the given VHDX format virtual disk.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 1/5/2012 12:21 PM 21487419392 win2k3-boot.vhdx </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaVirtualDiskAlignment</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Restore-NaHostFile</command:name> <maml:description> <maml:para>Restore a single file from a snapshot.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Restore</command:verb> <command:noun>NaHostFile</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Restore a single file from a snapshot. The file is cloned from a temporary LUN backed by the given snapshot. This cmdlet requires Data ONTAP 8.1 or later.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Restore-NaHostFile</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>Full path to the file to restore.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>Snapshot</maml:name> <maml:description> <maml:para>Name of the snapshot to use to restore the file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>MountPoint</maml:name> <maml:description> <maml:para>Mount point to give to the temporary LUN. If the LUN is not assigned a drive letter by the host, this mount point is used. If not provided and a drive letter is not automatically assigned by the host, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Overwrite</maml:name> <maml:description> <maml:para>If provided, the original file will be overwritten. If not provided, a backup of the original file will be kept with the extension ".bkup".</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >AbstractController</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>Full path to the file to restore.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Snapshot</maml:name> <maml:description> <maml:para>Name of the snapshot to use to restore the file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>MountPoint</maml:name> <maml:description> <maml:para>Mount point to give to the temporary LUN. If the LUN is not assigned a drive letter by the host, this mount point is used. If not provided and a drive letter is not automatically assigned by the host, the cmdlet will fail.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Overwrite</maml:name> <maml:description> <maml:para>If provided, the original file will be overwritten. If not provided, a backup of the original file will be kept with the extension ".bkup".</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Controller</maml:name> <maml:description> <maml:para>The Data ONTAP controller object, embodied by an NaController object. This parameter is returned by the Connect-NaController cmdlet. If not specified, the value in the global variable CurrentNaController is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">AbstractController</command:parameterValue> <dev:type> <maml:name>AbstractController</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Restore-NaHostFile K:\vm1.vhd snapshot1</dev:code> <dev:remarks> <maml:para>Restore the file K:\vm1.vhd from snapshot1.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 5/30/2012 4:09 PM 107374182912 vm1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Copy-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Set-NaHostDisk</command:name> <maml:description> <maml:para>Set basic Windows disk options (offline, online, partition style).</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Set</command:verb> <command:noun>NaHostDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Set basic Windows disk options (offline, online, partition style). This cmdlet must be run with administrative privileges and is only supported on Windows Vista sp1, Server 2008 or later.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>PartitionStyle</maml:name> <maml:description> <maml:para>Partition style (Gpt or Mbr)</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >PartitionStyle</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>Online</maml:name> <maml:description> <maml:para>Bring the disk online</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>ReadOnly</maml:name> <maml:description> <maml:para>Bring the disk online in a read-only state</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "2" > <maml:name>Offline</maml:name> <maml:description> <maml:para>Bring the disk offline</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>A windows disk index/number</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>PartitionStyle</maml:name> <maml:description> <maml:para>Partition style (Gpt or Mbr)</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">PartitionStyle</command:parameterValue> <dev:type> <maml:name>PartitionStyle</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Online</maml:name> <maml:description> <maml:para>Bring the disk online</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ReadOnly</maml:name> <maml:description> <maml:para>Bring the disk online in a read-only state</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Offline</maml:name> <maml:description> <maml:para>Bring the disk offline</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.DiskResource</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaHostDisk 4 -Offline</dev:code> <dev:remarks> <maml:para>Set disk 4 offline</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Initialize-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Set-NaHostVolumeSize</command:name> <maml:description> <maml:para>Grow or shrink a Windows volume.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Set</command:verb> <command:noun>NaHostVolumeSize</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Grow or shrink a Windows volume. This is done non-disruptively on active volumes. Note that in some cases due to unmovable files or parent disk size, it may not be possible to grow or shrink as much as you would like. This cmdlet must be run with administrative privileges and is only supported on Windows Vista sp1, Server 2008 or later.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-NaHostVolumeSize</maml:name> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Size</maml:name> <maml:description> <maml:para>Shrink or grow the volume by a specific size. Do not use with -Minimum or -Maximum.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Minimum</maml:name> <maml:description> <maml:para>Shrink the volume to the minimum size possible. Do not use with -Size or -Maximum.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Maximum</maml:name> <maml:description> <maml:para>Grow the volume to the maximum size for the parent disk or LUN. Do not use with -Size or -Minimum</maml:para> </maml:description> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-NaHostVolumeSize</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Guid</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Size</maml:name> <maml:description> <maml:para>Shrink or grow the volume by a specific size. Do not use with -Minimum or -Maximum.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Minimum</maml:name> <maml:description> <maml:para>Shrink the volume to the minimum size possible. Do not use with -Size or -Maximum.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Maximum</maml:name> <maml:description> <maml:para>Grow the volume to the maximum size for the parent disk or LUN. Do not use with -Size or -Minimum</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890ab}\) or a path to any file on the volume to process</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Size</maml:name> <maml:description> <maml:para>Shrink or grow the volume by a specific size. Do not use with -Minimum or -Maximum.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Minimum</maml:name> <maml:description> <maml:para>Shrink the volume to the minimum size possible. Do not use with -Size or -Maximum.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Maximum</maml:name> <maml:description> <maml:para>Grow the volume to the maximum size for the parent disk or LUN. Do not use with -Size or -Minimum</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>VdsId</maml:name> <maml:description> <maml:para>The Guid object which uniquely identifies the volume in VDS. Note that this is not the same as the volume guid path.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue> <dev:type> <maml:name>Guid</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Windows.HostVolume</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaHostVolumeSize E:\ -Minimum</dev:code> <dev:remarks> <maml:para>Shrink the E:\ volume to the minimum possible size.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaHostVolumeSize E:\ -Size "+50%"</dev:code> <dev:remarks> <maml:para>Grow the E:\Volume by 50%.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Get-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Mount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Dismount-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Set-NaVirtualDiskSize</command:name> <maml:description> <maml:para>Resize a VHD or VHDX format virtual disk.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Set</command:verb> <command:noun>NaVirtualDiskSize</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Resize a VHD or VHDX format virtual disk. A VHD must reside on a Data ONTAP LUN. A VHDX may reside on a Data ONTAP LUN or a Data ONTAP CIFS share. The cmdlet supports growing and shrinking fixed size VHD and VHDX files. The cmdlet also supports growing dynamic VHDX files. If necessary, the NTFS file system inside the virtual disk is resized. A new VHD size must be between 12 MB and 2040 GB. A new VHDX size must be between 12 MB and 64 TB. Any blocks added or removed are zeroed on the Data ONTAP storage controller. Growing the virtual disk consumes no space until additional data is written, and shrinking the virtual disk reclaims all of the removed space. The file to be resized must be specified with a fully-qualified path that resides on a Data ONTAP LUN or, for VHDX files, a Data ONTAP CIFS share. Cluster-shared volumes (CSVs) are supported. Administrator privileges are required to use this cmdlet.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-NaVirtualDiskSize</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be resized.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "2" > <maml:name>Size</maml:name> <maml:description> <maml:para>Specify the VHD size using the following format: [+|-]<number>[k|m|g|t|%] If a leading '+' or '-' appears, it indicates that the VHD size is to be increased or decreased (respectively) by the indicated amount, else the amount is the absolute size to set. The optional trailing 'k', 'm', 'g', and 't' indicates the desired units, namely 'kilobytes', 'megabytes', 'gigabytes', and 'terabytes' (respectively). The optional trailing '%' indicates to increase or decrease the size of the VHD by a percentage of its current size. If the trailing unit character doesn't appear, then <number> is interpreted as the number of bytes desired.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Preserve</maml:name> <maml:description> <maml:para>Specify to leave all partitions within the VHD untouched. This is useful if the VHD file contains a non-Windows partition style, such as EXT3.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-NaVirtualDiskSize</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be resized.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Minimum</maml:name> <maml:description> <maml:para>Specify to shrink the VHD file as far as possible.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Preserve</maml:name> <maml:description> <maml:para>Specify to leave all partitions within the VHD untouched. This is useful if the VHD file contains a non-Windows partition style, such as EXT3.</maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>FullName</maml:name> <maml:description> <maml:para>The fully-qualified name of the VHD file to be resized.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="2"> <maml:name>Size</maml:name> <maml:description> <maml:para>Specify the VHD size using the following format: [+|-]<number>[k|m|g|t|%] If a leading '+' or '-' appears, it indicates that the VHD size is to be increased or decreased (respectively) by the indicated amount, else the amount is the absolute size to set. The optional trailing 'k', 'm', 'g', and 't' indicates the desired units, namely 'kilobytes', 'megabytes', 'gigabytes', and 'terabytes' (respectively). The optional trailing '%' indicates to increase or decrease the size of the VHD by a percentage of its current size. If the trailing unit character doesn't appear, then <number> is interpreted as the number of bytes desired.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Preserve</maml:name> <maml:description> <maml:para>Specify to leave all partitions within the VHD untouched. This is useful if the VHD file contains a non-Windows partition style, such as EXT3.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SkipUnmap</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnmapSize</maml:name> <maml:description> <maml:para></maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Minimum</maml:name> <maml:description> <maml:para>Specify to shrink the VHD file as far as possible.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.IO.FileInfo</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaVirtualDiskSize J:\GoldenVM1.vhd +100g</dev:code> <dev:remarks> <maml:para>Increase the VHD file 'GoldenVM1.vhd' by 100 GB.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/24/2011 4:46 PM 214748365312 GoldenVM1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaVirtualDiskSize E:\VM1.vhd +10%</dev:code> <dev:remarks> <maml:para>Increase the size of VM1.vhd by 10%.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 8/24/2011 4:46 PM 214748365312 VM1.vhd </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Set-NaVirtualDiskSize C:\ClusterStorage\Volume2\VirtualDisks\Win2k8R2_VM1.vhdx 90GB</dev:code> <dev:remarks> <maml:para>Increase the size of the given VHDX format virtual disk.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 5/15/2013 4:23 PM 96628375552 win2k8r2_vm1.vhdx </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>New-NaVirtualDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Remove-NaHostFile</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Start-NaHostDiskRescan</command:name> <maml:description> <maml:para>Start a Windows disk rescan to force enumeration of any recently added or removed disks.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Start</command:verb> <command:noun>NaHostDiskRescan</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Start a Windows disk rescan to force enumeration of any recently added or removed disks. This cmdlet must be run with administrative privileges.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Start-NaHostDiskRescan</maml:name> </command:syntaxItem> </command:syntax> <command:parameters> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Start-NaHostDiskRescan</dev:code> <dev:remarks> <maml:para>Begin rescanning disks.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Wait-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <!--Generated by Help Cmdlet Editor--> <command:details> <command:name>Wait-NaHostDisk</command:name> <maml:description> <maml:para>Wait for a specific disk to appear, or wait for ongoing changes to the disk list to settle.</maml:para> </maml:description> <maml:copyright> <maml:para /> <!--Add copy right info here.--> </maml:copyright> <command:verb>Wait</command:verb> <command:noun>NaHostDisk</command:noun> <!--Add Dev version info here.--> <dev:version /> </command:details> <maml:description> <!--This is the Description section--> <maml:para>Wait for a specific disk to appear, or wait for ongoing changes to the disk list to settle.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Wait-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByValue, ByPropertyName)" position = "1" > <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>The Windows disk index of a specific disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >UInt32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Timeout</maml:name> <maml:description> <maml:para>The length of time in milliseconds to wait for a specific disk, or for stability in the disk list, before giving up.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int64</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Wait-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "1" > <maml:name>ControllerLunPath</maml:name> <maml:description> <maml:para>The path of the LUN that backs the host disk being sought, in the form /vol/<volume>/<lun> or /vol/<volume>/<qtree>/<lun>.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "2" > <maml:name>ControllerName</maml:name> <maml:description> <maml:para>The name of the controller hosting the LUN that backs the host disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Timeout</maml:name> <maml:description> <maml:para>The length of time in milliseconds to wait for a specific disk, or for stability in the disk list, before giving up.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int64</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Wait-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "true (ByPropertyName)" position = "named" > <maml:name>SerialNumber</maml:name> <maml:description> <maml:para>The serial number of the host disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >String</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Timeout</maml:name> <maml:description> <maml:para>The length of time in milliseconds to wait for a specific disk, or for stability in the disk list, before giving up.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int64</command:parameterValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Wait-NaHostDisk</maml:name> <command:parameter required = "true" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>SettlingTime</maml:name> <maml:description> <maml:para>Length of disk population settling interval, in milliseconds. If specified, this cmdlet will wait for the host disk list to remain stable for at least this length of time.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int32</command:parameterValue> </command:parameter> <command:parameter required = "false" variableLength = "false" globbing = "false" pipelineInput = "false" position = "named" > <maml:name>Timeout</maml:name> <maml:description> <maml:para>The length of time in milliseconds to wait for a specific disk, or for stability in the disk list, before giving up.</maml:para> </maml:description> <command:parameterValue required="true" variableLength = "false" >Int64</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="1"> <maml:name>DiskIndex</maml:name> <maml:description> <maml:para>The Windows disk index of a specific disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Timeout</maml:name> <maml:description> <maml:para>The length of time in milliseconds to wait for a specific disk, or for stability in the disk list, before giving up.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int64</command:parameterValue> <dev:type> <maml:name>Int64</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="1"> <maml:name>ControllerLunPath</maml:name> <maml:description> <maml:para>The path of the LUN that backs the host disk being sought, in the form /vol/<volume>/<lun> or /vol/<volume>/<qtree>/<lun>.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="2"> <maml:name>ControllerName</maml:name> <maml:description> <maml:para>The name of the controller hosting the LUN that backs the host disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named"> <maml:name>SerialNumber</maml:name> <maml:description> <maml:para>The serial number of the host disk being sought.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>SettlingTime</maml:name> <maml:description> <maml:para>Length of disk population settling interval, in milliseconds. If specified, this cmdlet will wait for the host disk list to remain stable for at least this length of time.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri/> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DataONTAP.HostUtilities.DiskDiscovery.DiskResource</maml:name> <maml:uri /> <maml:description> <maml:para></maml:para> </maml:description> </dev:type> <maml:description></maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors> </command:terminatingErrors> <command:nonTerminatingErrors> </command:nonTerminatingErrors> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para>Category: host</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title> -------------- Example 1 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Start-NaHostDiskRescan; Wait-NaHostDisk -SettlingTime 5000</dev:code> <dev:remarks> <maml:para>Initiate a disk rescan and wait until any changes to the disk population are complete.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para> </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------- Example 2 -------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> C:\PS> </maml:introduction> <dev:code>Start-NaHostDiskRescan; Wait-NaHostDisk -ControllerLunPath /vol/vol1/lun3 -ControllerName benson | New-NaHostVolume</dev:code> <dev:remarks> <maml:para>Start a VDS rescan, wait for the given disk to become available and create a volume.</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para>MountPoints Disk Size GuidPaths ----------- ---- ---- --------- {L:\} 11 994.0 MB {\\?\Volume{e092a3af-4176-4a48-808f-e865f8b35c48}\} </maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText> </command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Get-NaHostDisk</maml:linkText> <maml:uri/> </maml:navigationLink> <maml:navigationLink> <maml:linkText>New-NaHostVolume</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> </helpItems> |