Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Rename-NaDirectory


NAME
Rename-NaDirectory

SYNOPSIS
Rename a directory.

SYNTAX
Rename-NaDirectory [-Path] <String> [-NewPath] <String> [-Controller <NaCont
roller>] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION
Rename a directory. Note that this API cannot be used to rename a directory
to a different volume.


PARAMETERS
-Path <String>
Path of the directory, i.e. /vol/<volumename>/<dirname>.

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

-NewPath <String>
New path of the directory, i.e. /vol/<volumename>/<dirname>. All path c
omponents except the final directory name must already exist.

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

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

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.Types.File.FileInfo


NOTES


Category: file
API: file-rename-directory

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

C:\PS>Rename-NaDirectory /vol/vol0/etc/testdir /vol/vol0/etc/mydir


Rename /etc directory 'testdir' to 'mydir'.


Name : /vol/vol0/etc/mydir
FileType : directory
FileSize : 4096
CreationTimestampDT : 8/30/2010 9:16:21 PM
ChangedTimestampDT : 8/30/2010 9:20:56 PM
ModifiedTimestampDT : 8/30/2010 9:16:21 PM
AccessedTimestampDT : 8/30/2010 9:18:09 PM
AclType : nt_acl
OwnerId : 0
GroupId : 0
Perm : 700
HardLinksCount : 2
InodeNumber : 3600111
IsEmpty :



RELATED LINKS
New-NaDirectory
Read-NaDirectory
Remove-NaDirectory







 Data ONTAP® PowerShell Toolkit