New-Item
建立新項目。
語法
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 目錄中建立安全性項目。
請參閱
概念
about_Providers
Get-Item
Set-Item
Remove-Item
Clear-Item
Invoke-Item
Rename-Item
Move-Item
Copy-Item