PropertyCmdletProviderIntrinsics.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

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

New(String, String, String, Object)	Creates a new property on the specified item.
New(String[], String, String, Object, Boolean, Boolean)	Creates a new property on the specified item.

New(String, String, String, Object)

Creates a new property on the specified item.

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ New(System::String ^ path, System::String ^ propertyName, System::String ^ propertyTypeName, System::Object ^ value);

public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> New (string path, string propertyName, string propertyTypeName, object value);

member this.New : string * string * string * obj -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>

Public Function New (path As String, propertyName As String, propertyTypeName As String, value As Object) As Collection(Of PSObject)

Parameters

path: String

The path to the item on which the new property should be created.

propertyName: String

The name of the property that should be created.

propertyTypeName: String

The type of the property that should be created.

value: Object

The new value of the property that should be created.

Returns

Collection<PSObject>

A PSObject for each item that the property was created on. The PSObject contains the properties that were created.

Exceptions

ArgumentNullException

If path 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, Boolean)

Creates a new property on the specified item.

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ New(cli::array <System::String ^> ^ path, System::String ^ propertyName, System::String ^ propertyTypeName, System::Object ^ value, bool force, bool literalPath);

public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> New (string[] path, string propertyName, string propertyTypeName, object value, bool force, bool literalPath);

member this.New : string[] * string * string * obj * bool * bool -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>

Public Function New (path As String(), propertyName As String, propertyTypeName As String, value As Object, force As Boolean, literalPath As Boolean) As Collection(Of PSObject)