New-Item for Security

Creates a new item.

Syntax

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

Description

The New-Item cmdlet creates a new item and sets its value. The types of items that can be created depend upon the location of the item. For example, in the file system, New-Item is used to create files and folders. In the registry, New-Item creates registry keys and entries.

In the Security directory, you can use the New-Item cmdlet to create and configure Plugin security.

Parameters

-URI

Identifies the URI for which access is authorized based on the value of the Sddl parameter.

Required? false
Position? named
Default Value
Accept Pipeline Input? false
Accept Wildcard Characters? false

-SDDL

Specifies the Security Descriptor Definition Language (SDDL) for the access control entry. This identifies the security settings that are used to authorize access to a specified resource URI.

Required? false
Position? named
Default Value
Accept Pipeline Input? false
Accept Wildcard Characters? false

-ExactMatch

Specifies how to use the security settings that are specified in the Sddl parameter. If the ExactMatch parameter is set to True, the security settings in Sddl are used only to authorize access attempts to the URI exactly as specified by the URI.

If ExactMatch is set to false, the security settings in Sddl are used to authorize access attempts to the URIs that begin with the string specified in the URI.

Required? false
Position? named
Default Value
Accept Pipeline Input? false
Accept Wildcard Characters? false

-Confirm

Prompts you for confirmation before executing the command.

Required? false
Position? named
Default Value
Accept Pipeline Input? false
Accept Wildcard Characters? false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required? false
Position? named
Default Value
Accept Pipeline Input? false
Accept Wildcard Characters? false

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs System.Object

You can pipe a value for the new item to the New-Item cmdlet.
Outputs Any

Notes

The New-Item cmdlet is designed to work with the data exposed by any provider. To list the providers available in your session, type "Get-PsProvider". For more information, see About_Providers.

Example 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)"  

This command creates a security entry in the Security directory of Resource_5967683 (a specific resource).  

See Also

about_Providers
Get-Item
Set-Item
Remove-Item
Clear-Item
Invoke-Item
Rename-Item
Move-Item
Copy-Item