Delen via

New-Object

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee maakt u een exemplaar van een Microsoft .NET Framework- of COM-object.

Syntax

New-Object
   [-TypeName] <String>
   [[-ArgumentList] <Object[]>]
   [-Property <IDictionary>]
   [<CommonParameters>]
New-Object
   [-ComObject] <String>
   [-Strict]
   [-Property <IDictionary>]
   [<CommonParameters>]

Description

De New-Object cmdlet maakt een exemplaar van een .NET Framework- of COM-object.

U kunt het type van een .NET Framework klasse of een ProgID van een COM-object opgeven. Standaard typt u de volledig gekwalificeerde naam van een .NET Framework klasse en de cmdlet retourneert een verwijzing naar een exemplaar van die klasse. Als u een exemplaar van een COM-object wilt maken, gebruikt u de parameter ComObject en geeft u de ProgID van het object op als de waarde.

Voorbeelden

Voorbeeld 1: een System.Version-object Creatie

In dit voorbeeld wordt een System.Version-object gemaakt met de tekenreeks 1.2.3.4 als constructor.

New-Object -TypeName System.Version -ArgumentList "1.2.3.4"

Major  Minor  Build  Revision
-----  -----  -----  --------
1      2      3      4

Voorbeeld 2: een COM-object in Internet Explorer Creatie

In dit voorbeeld worden twee exemplaren van het COM-object gemaakt dat de Internet Explorer-toepassing vertegenwoordigt. In het eerste exemplaar wordt de hashtabel Eigenschapparameter gebruikt om de methode Navigate2 aan te roepen en de eigenschap Visible van het object in te stellen op $True om de toepassing zichtbaar te maken. Het tweede exemplaar krijgt dezelfde resultaten met afzonderlijke opdrachten.

$IE1 = New-Object -COMObject InternetExplorer.Application -Property @{Navigate2="www.microsoft.com"; Visible = $True}

# The following command gets the same results as the example above.
$IE2 = New-Object -COMObject InternetExplorer.Application`
$IE2.Navigate2("www.microsoft.com")`
$IE2.Visible = $True`

Voorbeeld 3: de parameter Strict gebruiken om een niet-afsluitfout te genereren

Dit voorbeeld laat zien dat het toevoegen van de parameter Strict ertoe leidt dat de New-Object cmdlet een niet-afsluitfout genereert wanneer het COM-object een assembly interoperabiliteit gebruikt.

$A = New-Object -COMObject Word.Application -Strict -Property @{Visible = $True}

New-Object : The object written to the pipeline is an instance of the type
"Microsoft.Office.Interop.Word.ApplicationClass" from the component's primary interop assembly. If
this type exposes different members than the IDispatch members, scripts written to work with this
object might not work if the primary interop assembly is not installed.

At line:1 char:14
+ $A = New-Object  <<<< -COM Word.Application -Strict; $a.visible=$true

Voorbeeld 4: een COM-object Creatie om het Windows-bureaublad te beheren

In dit voorbeeld ziet u hoe u een COM-object maakt en gebruikt om uw Windows-bureaublad te beheren.

De eerste opdracht maakt gebruik van de comObject parameter van de New-Object cmdlet om een COM-object te maken met de Shell.Application ProgID. Het resulterende object wordt opgeslagen in de $ObjShell variabele. Met de tweede opdracht wordt de $ObjShell variabele doorverwijzen naar de Get-Member cmdlet, waarmee de eigenschappen en methoden van het COM-object worden weergegeven. Een van de methoden is de Methode ToggleDesktop . Met de derde opdracht wordt de methode ToggleDesktop van het object aangeroepen om de geopende vensters op uw bureaublad te minimaliseren.

$Objshell = New-Object -COMObject "Shell.Application"
$objshell | Get-Member
$objshell.ToggleDesktop()

TypeName: System.__ComObject#{866738b9-6cf2-4de8-8767-f794ebe74f4e}

Name                 MemberType Definition
----                 ---------- ----------
AddToRecent          Method     void AddToRecent (Variant, string)
BrowseForFolder      Method     Folder BrowseForFolder (int, string, int, Variant)
CanStartStopService  Method     Variant CanStartStopService (string)
CascadeWindows       Method     void CascadeWindows ()
ControlPanelItem     Method     void ControlPanelItem (string)
EjectPC              Method     void EjectPC ()
Explore              Method     void Explore (Variant)
ExplorerPolicy       Method     Variant ExplorerPolicy (string)
FileRun              Method     void FileRun ()
FindComputer         Method     void FindComputer ()
FindFiles            Method     void FindFiles ()
FindPrinter          Method     void FindPrinter (string, string, string)
GetSetting           Method     bool GetSetting (int)
GetSystemInformation Method     Variant GetSystemInformation (string)
Help                 Method     void Help ()
IsRestricted         Method     int IsRestricted (string, string)
IsServiceRunning     Method     Variant IsServiceRunning (string)
MinimizeAll          Method     void MinimizeAll ()
NameSpace            Method     Folder NameSpace (Variant)
Open                 Method     void Open (Variant)
RefreshMenu          Method     void RefreshMenu ()
ServiceStart         Method     Variant ServiceStart (string, Variant)
ServiceStop          Method     Variant ServiceStop (string, Variant)
SetTime              Method     void SetTime ()
ShellExecute         Method     void ShellExecute (string, Variant, Variant, Variant, Variant)
ShowBrowserBar       Method     Variant ShowBrowserBar (string, Variant)
ShutdownWindows      Method     void ShutdownWindows ()
Suspend              Method     void Suspend ()
TileHorizontally     Method     void TileHorizontally ()
TileVertically       Method     void TileVertically ()
ToggleDesktop        Method     void ToggleDesktop ()
TrayProperties       Method     void TrayProperties ()
UndoMinimizeALL      Method     void UndoMinimizeALL ()
Windows              Method     IDispatch Windows ()
WindowsSecurity      Method     void WindowsSecurity ()
WindowSwitcher       Method     void WindowSwitcher ()
Application          Property   IDispatch Application () {get}
Parent               Property   IDispatch Parent () {get}

Voorbeeld 5: meerdere argumenten doorgeven aan een constructor

In dit voorbeeld ziet u hoe u een object maakt met een constructor die meerdere parameters gebruikt. De parameters moeten in een matrix worden geplaatst wanneer u de parameter ArgumentList gebruikt.

$array = @('One', 'Two', 'Three')
$parameters = @{
    TypeName = 'System.Collections.Generic.HashSet[string]'
    ArgumentList = ([string[]]$array, [System.StringComparer]::OrdinalIgnoreCase)
}
$set = New-Object @parameters

PowerShell verbindt elk lid van de matrix met een parameter van de constructor.

Notitie

In dit voorbeeld wordt parametersplatting gebruikt voor leesbaarheid. Zie about_Splatting voor meer informatie.

Voorbeeld 6: een constructor aanroepen die een matrix als één parameter gebruikt

In dit voorbeeld ziet u hoe u een object maakt met een constructor die een parameter gebruikt die een matrix of verzameling is. De matrixparameter moet in een wrapped in een andere matrix worden geplaatst.

$array = @('One', 'Two', 'Three')
# This command throws an exception.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList $array
# This command succeeds.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList (,[string[]]$array)
$set

New-Object : Cannot find an overload for "HashSet`1" and the argument count: "3".
At line:1 char:8
+ $set = New-Object -TypeName 'System.Collections.Generic.HashSet[strin ...
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidOperation: (:) [New-Object], MethodException
+ FullyQualifiedErrorId : ConstructorInvokedThrowException,Microsoft.PowerShell.Commands.NewObjectCommand

One
Two
Three

De eerste poging om het object in dit voorbeeld te maken mislukt. PowerShell heeft geprobeerd de drie leden van $array te binden aan parameters van de constructor, maar de constructor heeft geen drie parameters nodig. Door in een andere matrix te verpakken $array , voorkomt u dat PowerShell probeert de drie leden van $array te binden aan parameters van de constructor.

Parameters

-ArgumentList

Hiermee geeft u een matrix van argumenten die moeten worden doorgegeven aan de constructor van de klasse .NET Framework. Als de constructor één parameter gebruikt die een matrix is, moet u die parameter in een andere matrix verpakken. Bijvoorbeeld:

$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate -ArgumentList (,$bytes)

Zie about_Splatting voor meer informatie over het gedrag van ArgumentList.

De alias voor ArgumentList is Args.

Type:Object[]
Aliases:Args
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComObject

Hiermee geeft u de programmatische id (ProgID) van het COM-object.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Property

Hiermee stelt u eigenschapswaarden in en roept u methoden van het nieuwe object aan.

Voer een hashtabel in waarin de sleutels de namen van eigenschappen of methoden zijn en de waarden eigenschapswaarden of methodeargumenten zijn. New-Object maakt het object en stelt elke eigenschapswaarde in en roept elke methode aan in de volgorde waarin deze worden weergegeven in de hash-tabel.

Als het nieuwe object is afgeleid van de klasse PSObject en u een eigenschap opgeeft die niet bestaat in het object, New-Object voegt u de opgegeven eigenschap toe aan het object als een NoteProperty. Als het object geen PSObject is, genereert de opdracht een niet-afsluitfout.

Type:IDictionary
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Strict

Geeft aan dat de cmdlet een niet-afsluitfout genereert wanneer een COM-object dat u probeert te maken gebruikmaakt van een interoperabiliteitsassembly. Met deze functie worden werkelijke COM-objecten onderscheiden van .NET Framework-objecten met COM-aanroepbare wrappers.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TypeName

Hiermee geeft u de volledig gekwalificeerde naam van de .NET Framework klasse. U kunt niet zowel de parameter TypeName als de comObject-parameter opgeven.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsnijden naar deze cmdlet.

Uitvoerwaarden

Object

Deze cmdlet retourneert het object dat wordt gemaakt.

Notities

  • New-Object biedt de meest gebruikte functionaliteit van de functie VBScript CreateObject. Een instructie zoals Set objShell = CreateObject("Shell.Application") in VBScript kan worden vertaald naar $objShell = New-Object -COMObject "Shell.Application" in PowerShell.
  • New-Objectbreidt de functionaliteit uit die beschikbaar is in de Windows Script Host-omgeving door het eenvoudig te maken om met .NET Framework objecten te werken vanaf de opdrachtregel en in scripts.