Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten New-CimInstance skapar en instans av en CIM-klass baserat på klassdefinitionen på antingen den lokala datorn eller en fjärrdator. Som standard skapar cmdleten New-CimInstance en instans på den lokala datorn.
Exempel
Exempel 1: Skapa en instans av en CIM-klass
Det här exemplet skapar en instans av en CIM-klass med namnet win32_environment i namnområdet root/cimv2 på datorn.
Ingen validering på klientsidan utförs om klassen inte finns, egenskaperna är felaktiga eller om servern avvisar anropet. Om instansen skapas framgångsrikt, så ger cmdleten ut den nyligen skapade instansen.
Exempel 2: Skapa en instans av en CIM-klass med hjälp av ett klassschema
Det här exemplet hämtar ett CIM-klassobjekt och lagrar det i en variabel med namnet $class. Innehållet i variabeln skickas sedan till cmdleten New-CimInstance.
Det här exemplet skapar en dynamisk instans av en CIM-klass med namnet Win32_Process på klientdatorn utan att hämta instansen från servern. Den nya instansen lagras i variabeln $a. Den här dynamiska instansen kan användas för att utföra åtgärder om instansen med den här nyckeln finns på servern.
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
Cmdleten Get-CimInstance hämtar sedan en viss enskild instans. Cmdleten Invoke-CimMethod anropar metoden GetOwner på den hämtade instansen.
Exempel 4: Skapa en instans för en CIM-klass för ett specifikt namnområde
Det här exemplet hämtar en instans av en CIM-klass med namnet MSFT_Something i namnområdet rot/någonstans och lagrar den i en variabel med namnet $class. Variabeln skickas till cmdleten New-CimInstance för att skapa en ny CIM-instans och utföra valideringar på klientsidan på den nya instansen.
I det här exemplet kontrollerar parametern CimClass i stället för parametern ClassName att Prop1- och Prop2- faktiskt finns och att nycklarna har markerats korrekt.
Du kan inte använda parametern ComputerName eller CimSession med parametern 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.
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.
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.
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.
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.
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.
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.
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:
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 endast 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.
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.