New-CimInstance

Syntax

ClassNameComputerSet (Standard)

New-CimInstance
    [-ClassName] <String>
    [[-Property] <IDictionary>]
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClassNameSessionSet

New-CimInstance
    [-ClassName] <String>
    [[-Property] <IDictionary>]
    -CimSession <CimSession[]>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriSessionSet

New-CimInstance
    [[-Property] <IDictionary>]
    -ResourceUri <Uri>
    -CimSession <CimSession[]>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriComputerSet

New-CimInstance
    [[-Property] <IDictionary>]
    -ResourceUri <Uri>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassSessionSet

New-CimInstance
    [-CimClass] <CimClass>
    [[-Property] <IDictionary>]
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassComputerSet

New-CimInstance
    [-CimClass] <CimClass>
    [[-Property] <IDictionary>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exempel

Exempel 1: Skapa en instans av en CIM-klass

$prop = @{
    Name = "testvar"
    VariableValue = "testvalue"
    UserName = "domain\user"
}
New-CimInstance -ClassName Win32_Environment -Property $prop

Exempel 2: Skapa en instans av en CIM-klass med hjälp av ett klassschema

$class = Get-CimClass -ClassName Win32_Environment
$prop = @{
    Name = "testvar"
    VariableValue = "testvalue"
    UserName = "Contoso\User1"
}
New-CimInstance -CimClass $class -Property $prop

Exempel 3: Skapa en dynamisk instans på klienten

$instance = @{
    ClassName = 'Win32_Process'
    Property = @{
        Handle = 0
    }
    Key = 'Handle'
    ClientOnly = $true
}
$a = New-CimInstance @instance

Get-CimInstance -CimInstance $a
Invoke-CimMethod -CimInstance $a -MethodName GetOwner

ProcessId Name                HandleCount WorkingSetSize VirtualSize
--------- ----                ----------- -------------- -----------
0         System Idle Process 0           8192           8192

Domain         :
ReturnValue    : 2
User           :
PSComputerName :

Exempel 4: Skapa en instans för en CIM-klass för ett specifikt namnområde

$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere
New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly

Parametrar

-CimClass

Anger ett CIM-klassobjekt som representerar instanstypen. Använd cmdleten Get-CimClass för att hämta klassdeklarationen från en dator. Med den här parametern resulterar det i bättre schemavalidering på klientsidan.

Parameteregenskaper

Parameteruppsättningar

-CimSession

Kör kommandot med den angivna CIM-sessionen. Ange en variabel som innehåller CIM-sessionen eller ett kommando som skapar eller hämtar CIM-sessionen, till exempel cmdletarna New-CimSession eller Get-CimSession. Mer information finns i about_CimSession.

Parameteregenskaper

Parameteruppsättningar

-ClassName

Anger namnet på den CIM-klass som åtgärden skapar en instans av. Obs! Du kan använda tabbavslut för att bläddra i listan över klasser eftersom PowerShell hämtar en lista över klasser från den lokala WMI-servern för att tillhandahålla en lista med klassnamn.

Parameteregenskaper

Parameteruppsättningar

-ClientOnly

Anger att instansen bara skapas i PowerShell utan att gå till CIM-servern. Du kan använda den här parametern för att skapa en minnesintern CIM-instans för användning i efterföljande PowerShell-åtgärder.

Parameteregenskaper

Parameteruppsättningar

-ComputerName

Anger namnet på den dator där du vill köra CIM-åtgärden. Du kan ange ett fullständigt domännamn (FQDN), ett NetBIOS-namn eller en IP-adress.

Om du anger den här parametern skapar cmdleten en tillfällig session till den angivna datorn med hjälp av WSMan-protokollet.

Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Komponentobjektmodell (COM).

Om flera åtgärder utförs på samma dator ger anslutning med en CIM-session bättre prestanda.

Parameteregenskaper

Parameteruppsättningar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Parameteruppsättningar

-Key

Anger de egenskaper som används som nycklar. CimSession och ComputerName kan inte användas när Key anges.

Parameteregenskaper

Parameteruppsättningar

-Namespace

Anger klassens namnområde för den nya instansen. Standardnamnområdet är root/CIMV2. Du kan använda tabbavslut för att bläddra i listan över namnområden, eftersom PowerShell hämtar en lista över namnområden från den lokala WMI-servern för att tillhandahålla listan över namnområden.

Parameteregenskaper

Parameteruppsättningar

-OperationTimeoutSec

Anger hur lång tid cmdleten väntar på ett svar från CIM-servern. Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern. Om parametern OperationTimeoutSec anges till ett värde som är mindre än den robusta tidsgränsen för återförsök på 3 minuter kan nätverksfel som varar mer än värdet för parametern OperationTimeoutSec inte återställas eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.

Parameteregenskaper

Parameteruppsättningar

-Property

Anger egenskaperna för CIM-instansen med hjälp av en hash-tabell (namn/värde-par).

Om du anger parametern CimClass utför cmdleten New-CimInstance en egenskapsverifiering på klienten för att se till att de angivna egenskaperna överensstämmer med klassdeklarationen på servern. Om parametern CimClass inte anges görs egenskapsverifieringen på servern.

Parameteregenskaper

Parameteruppsättningar

-ResourceUri

Anger resursens enhetliga resursidentifierare (URI) för resursklassen eller instansen. URI:n används för att identifiera en specifik typ av resurs, till exempel diskar eller processer, på en dator.

En URI består av ett prefix och en sökväg till en resurs. Till exempel:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Om du inte anger den här parametern används som standard URI för DMTF-standardresursen http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ och klassnamnet läggs till i den.

ResourceUri- kan bara användas med CIM-sessioner som skapats med hjälp av WSMan-protokollet, eller när du anger parametern ComputerName, som skapar en CIM-session med WSMan. Om du anger den här parametern utan att ange parametern ComputerName, eller om du anger en CIM-session som skapats med DCOM-protokollet, får du ett fel eftersom DCOM-protokollet inte stöder parametern ResourceUri.

Om både parametern ResourceUri och parametern Filter anges ignoreras parametern Filter.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

None

Utdata

CimInstance

Kommentarer

Relaterade länkar

• Get-CimClass
• Get-CimInstance
• Ta bort CimInstans
• Set-CimInstance