Out-File -Force doesn't seem to work as advertised

I'm having a bit of trouble with Out-File, from Get-Help Out-File -detailed:

-force <SwitchParameter>
Overrides restrictions that prevent the command from succeeding, just so the changes do not compromise security
. For example, Force will override the read-only attribute or create directories to complete a file path, but i
t will not attempt to change file permissions.

However:

PS C:\temp> out-file -FilePath .\foo\bar.txt -InputObject "String" -Force
Out-File : Could not find a part of the path 'C:\temp\foo\bar.txt'.
At line:1 char:9
+ out-file <<<< -FilePath .\foo\bar.txt -InputObject "String" -Force

Am I doing something wrong, or is this something I should submit to connect?

^_^ ~Clint

Looks like either a bug or something they intended to do, documented, and didn't get to . Take yer pick. But you're right, it won't create the path for you.

--
Don Jones
Windows PowerShell MVP
Founder: www.ScriptingAnswers.com
Co-Author: "Windows PowerShell: TFM"

"Clint Bergman" <clint@psd267.wednet.edu> wrote in message news:O4bqp9%23kHHA.1624@TK2MSFTNGP06.phx.gbl...
I'm having a bit of trouble with Out-File, from Get-Help Out-File -detailed:

-force <SwitchParameter>
Overrides restrictions that prevent the command from succeeding, just so the changes do not compromise security
. For example, Force will override the read-only attribute or create directories to complete a file path, but i
t will not attempt to change file permissions.

However:

PS C:\temp> out-file -FilePath .\foo\bar.txt -InputObject "String" -Force
Out-File : Could not find a part of the path 'C:\temp\foo\bar.txt'.
At line:1 char:9
+ out-file <<<< -FilePath .\foo\bar.txt -InputObject "String" -Force

Am I doing something wrong, or is this something I should submit to connect?

^_^ ~Clint