Thanks for putting me on the right track (for some reason, I was unsure that it was "just about the Attributes"... my bad ;-) )
I've written a small script to experiment with part 1 of my question: reading/decoding the "OneDrive status."
Here's the script:
foreach ($v in [enum]::GetValues([System.IO.FileAttributes]))
{
Write-Host('0x{0:X8}: {1}' -f [int] $v, $v)
}
# from C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\um\winnt.h
$FILE_ATTRIBUTE_UNPINNED = 0x00100000 # NOT documented at https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117%28v=vs.85%29.aspx
$FILE_ATTRIBUTE_PINNED = 0x00080000 # NOT documented at https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117%28v=vs.85%29.aspx
$FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS = 0x00400000 # documented at https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117%28v=vs.85%29.aspx
$itempaths = @(
'D:\users\sto\onedrive\Free up space.txt',
'D:\users\sto\onedrive\Always keep on this device.txt',
'D:\users\sto\onedrive\Created on this device.txt',
'd:\users\sto\onedrive\somefile.txt',
'd:\users\sto\photos\Cleanup.ps1',
'D:\users\sto\onedrive\Free up space',
'D:\users\sto\onedrive\Always keep on this device',
'D:\users\sto\onedrive\Created on this device')
foreach ($itempath in $itempaths)
{
$item = get-item $itempath
$attributes = $item.Attributes
$hexattributes = '0x{0:X8}' -f [int] $attributes
$knownattributes = $attributes -band (-bnot ($FILE_ATTRIBUTE_UNPINNED -bor $FILE_ATTRIBUTE_PINNED -bor $FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS))
Add-Member -InputObject $item -MemberType NoteProperty -Name HexAttributes -Value $hexattributes
Add-Member -InputObject $item -MemberType NoteProperty -Name KnownAttributes -TypeName [System.IO.FileAttributes] -Value $knownattributes
$pinned = ($attributes -band $FILE_ATTRIBUTE_PINNED) -ne 0
Add-Member -InputObject $item -MemberType NoteProperty -Name FILE_ATTRIBUTE_PINNED -TypeName [System.Boolean] -Value $pinned
$unpinned = ($attributes -band $FILE_ATTRIBUTE_UNPINNED) -ne 0
Add-Member -InputObject $item -MemberType NoteProperty -Name FILE_ATTRIBUTE_UNPINNED -TypeName [System.Boolean] -Value $unpinned
$recall_on_access = ($attributes -band $FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS) -ne 0
Add-Member -InputObject $item -MemberType NoteProperty -Name FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS -TypeName [System.Boolean] -Value $recall_on_access
$item | Select-Object -Property FullName, Length, Attributes, HexAttributes, KnownAttributes, FILE_ATTRIBUTE_PINNED, FILE_ATTRIBUTE_UNPINNED, FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS
}
foreach ($itempath in $itempaths)
{
$item = get-item $itempath
$item | ft -AutoSize
}
And what it outputs:
0x00000001: ReadOnly
0x00000002: Hidden
0x00000004: System
0x00000010: Directory
0x00000020: Archive
0x00000040: Device
0x00000080: Normal
0x00000100: Temporary
0x00000200: SparseFile
0x00000400: ReparsePoint
0x00000800: Compressed
0x00001000: Offline
0x00002000: NotContentIndexed
0x00004000: Encrypted
0x00008000: IntegrityStream
0x00020000: NoScrubData
FullName : D:\users\sto\onedrive\Free up space.txt
Length : 2760
Attributes : 5248544
HexAttributes : 0x00501620
KnownAttributes : Archive, SparseFile, ReparsePoint, Offline
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : True
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : True
FullName : D:\users\sto\onedrive\Always keep on this device.txt
Length : 10388
Attributes : 525344
HexAttributes : 0x00080420
KnownAttributes : Archive, ReparsePoint
FILE_ATTRIBUTE_PINNED : True
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
FullName : D:\users\sto\onedrive\Created on this device.txt
Length : 2304
Attributes : Archive, ReparsePoint
HexAttributes : 0x00000420
KnownAttributes : Archive, ReparsePoint
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
FullName : D:\users\sto\onedrive\somefile.txt
Length : 7
Attributes : 5248544
HexAttributes : 0x00501620
KnownAttributes : Archive, SparseFile, ReparsePoint, Offline
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : True
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : True
FullName : D:\users\sto\photos\Cleanup.ps1
Length : 1217
Attributes : Archive
HexAttributes : 0x00000020
KnownAttributes : Archive
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
FullName : D:\users\sto\onedrive\Free up space
Length :
Attributes : 1049648
HexAttributes : 0x00100430
KnownAttributes : Directory, Archive, ReparsePoint
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : True
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
FullName : D:\users\sto\onedrive\Always keep on this device
Length :
Attributes : 525360
HexAttributes : 0x00080430
KnownAttributes : Directory, Archive, ReparsePoint
FILE_ATTRIBUTE_PINNED : True
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
FullName : D:\users\sto\onedrive\Created on this device
Length :
Attributes : Directory, Archive, ReparsePoint
HexAttributes : 0x00000430
KnownAttributes : Directory, Archive, ReparsePoint
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---l 2018-01-20 07:54 (2760) Free up space.txt
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---l 2018-01-20 07:55 10388 Always keep on this device.txt
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---l 2018-01-20 08:14 2304 Created on this device.txt
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---l 2017-05-18 12:44 (7) somefile.txt
Directory: D:\users\sto\photos
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 2017-08-16 16:21 1217 Cleanup.ps1
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
da---l 2018-01-20 08:56 Free up space
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
da---l 2018-01-20 08:56 Always keep on this device
Directory: D:\users\sto\onedrive
Mode LastWriteTime Length Name
---- ------------- ------ ----
da---l 2018-01-20 08:56 Created on this device
(BTW you'll notice that the default formatting for the Length property of a FileInfo object uses parentheses just like CMD's "DIR" does...)
Based on this, we have enough information to determine which of the three OneDrive "statuses" a file can be in:
- online-only
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : True
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : True
- locally available
FILE_ATTRIBUTE_PINNED : False
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
- always available
FILE_ATTRIBUTE_PINNED : True
FILE_ATTRIBUTE_UNPINNED : False
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS : False
Note that 3 attribute bits are involved, which should allow 8 combinations, but only 3 combinations are used (I would expect that the other 5 are not valid / supported).
There's a more general discussion about the meaning of all the "new" attribute bits at
https://superuser.com/questions/1214542/what-do-new-windows-8-10-attributes-mean-no-scrub-file-x-integrity-v-pinn/1287315 so I won't duplicate it here.
Now I'm going to move to part 2 of my question: how to change the status. At first glance, changing the attribute bits seems to be enough for files, but I still need to look at folders. Stay tuned ;-)
