ItemCmdletProviderIntrinsics.New Method

  • Reference

Definition

Namespace:
System.Management.Automation
Assembly:
System.Management.Automation.dll
Package:
Microsoft.PowerShell.5.1.ReferenceAssemblies v1.0.0
Package:
System.Management.Automation v7.0.13
Package:
System.Management.Automation v7.1.7
Package:
System.Management.Automation v7.2.12
Package:
System.Management.Automation v7.3.5
Package:
System.Management.Automation v7.4.0
Package:
Microsoft.WSMan.Runtime v6.1.0
Package:
Microsoft.WSMan.Runtime v6.2.0

Overloads

New(String, String, String, Object)

Creates a new item at the given path.
New(String[], String, String, Object, Boolean)

Creates a new item at the given path.

New(String, String, String, Object)

Creates a new item at the given path.

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ New(System::String ^ path, System::String ^ name, System::String ^ itemTypeName, System::Object ^ content);
public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> New (string path, string name, string itemTypeName, object content);
member this.New : string * string * string * obj -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>
Public Function New (path As String, name As String, itemTypeName As String, content As Object) As Collection(Of PSObject)

Parameters

path
String

The path to the container to create item in. It may be a drive or provider-qualified path and may include glob characters.

name
String

The name of the new item to create.

itemTypeName
String

The type of the new item to create.

content
Object

The content of the new item to create.

Returns

Collection<PSObject>

The item that was created.

Exceptions

ArgumentNullException

If path or propertyToClear is null.

ProviderNotFoundException

If the path refers to a provider that could not be found.

DriveNotFoundException

If the path refers to a drive that could not be found.

ItemNotFoundException

If path does not contain glob characters and could not be found.

NotSupportedException

If the provider that the path refers to does not support this operation.

ProviderInvocationException

If the provider threw an exception.

Applies to

New(String[], String, String, Object, Boolean)

Creates a new item at the given path.

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ New(cli::array <System::String ^> ^ path, System::String ^ name, System::String ^ itemTypeName, System::Object ^ content, bool force);
public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> New (string[] path, string name, string itemTypeName, object content, bool force);
member this.New : string[] * string * string * obj * bool -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>
Public Function New (path As String(), name As String, itemTypeName As String, content As Object, force As Boolean) As Collection(Of PSObject)

Parameters

path
String[]

The path(s) to the container to create item in. They may be drive or provider-qualified path and may include glob characters.

name
String

The name of the new item to create.

itemTypeName
String

The type of the new item to create.

content
Object

The content of the new item to create.

force
Boolean

Passed on to providers to force operations.

Returns

Collection<PSObject>

The item(s) that was created.

Exceptions

ArgumentNullException

If path or propertyToClear is null.

ProviderNotFoundException

If the path refers to a provider that could not be found.

DriveNotFoundException

If the path refers to a drive that could not be found.

ItemNotFoundException

If path does not contain glob characters and could not be found.

NotSupportedException

If the provider that the path refers to does not support this operation.

ProviderInvocationException

If the provider threw an exception.

Applies to