建立新項目。

語法

New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-確認] [-WhatIf] [<CommonParameters>]

描述

New-Item Cmdlet 會建立新項目並且設定項目的值。可以建立的項目類型會視項目的位置而異。例如在檔案系統中,New-Item 會用於建立檔案和資料夾。在登錄中,New-Item 會建立登錄機碼與項目。

在 Security 目錄中,您可以使用 New-Item Cmdlet 來建立及設定 Plugin 的安全性。

參數

-URI <Uri>

識別依據 Sddl 參數值授權存取的 URI。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-SDDL <string>

指定存取控制項目的安全性描述元定義語言 (SDDL)。此參數可識別

用來授權存取指定之資源 URI 的安全性設定。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-ExactMatch

指定如何使用 Sddl 參數中指定的安全性設定。如果 ExactMatch 參數設定為

True,則只有在嘗試存取 URI 中指定的 URI 時,Sddl 中的安全性設定才會用來進行授權。

如果 ExactMatch 設定為 false,則在嘗試存取以 URI 中指定之字串開頭的 URI 時,Sddl 中的安全性設定便會

用來進行授權。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-確認

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Object

您可以經由管道將新項目的值輸出至 New-Item Cmdlet。

輸出

Any

附註

New-Item Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者,請輸入 "Get-PsProvider"。如需詳細資訊,請參閱 About_Providers。

範例 1

C:\PS>New-Item -path WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683\Security -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

這個命令會在 Resource_5967683 (特定資源) 的 Security 目錄中建立安全性項目。






請參閱




目錄