Tato rutina je dostupná jenom na platformě Windows.
Rutina New-CimInstance vytvoří instanci třídy CIM na základě definice třídy na místním počítači nebo ve vzdáleném počítači. Ve výchozím nastavení rutina New-CimInstance vytvoří instanci v místním počítači.
Příklady
Příklad 1: Vytvoření instance třídy CIM
Tento příklad vytvoří instanci třídy CIM s názvem win32_environment v oboru názvů root/cimv2 v počítači.
Pokud třída neexistuje, nejsou provedeny žádné ověření na straně klienta, vlastnosti jsou nesprávné nebo pokud server odmítne volání. Pokud se instance úspěšně vytvoří, rutina vypíše nově vytvořenou instanci.
Příklad 2: Vytvoření instance třídy CIM pomocí schématu třídy
Tento příklad načte objekt třídy CIM a uloží ho do proměnné s názvem $class. Obsah proměnné se pak předá cmdletu New-CimInstance.
Příklad 3: Vytvoření dynamické instance v klientovi
Tento příklad vytvoří dynamickou instanci třídy CIM s názvem Win32_Process na klientském počítači bez získání instance ze serveru. Nová instance je uložena v proměnné $a. Tuto dynamickou instanci lze použít k provádění operací, pokud instance s tímto klíčem existuje na serveru.
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
Rutina Get-CimInstance pak načte konkrétní jednu instanci. Rutina Invoke-CimMethod volá metodu GetOwner na načtené instanci.
Příklad 4: Vytvoření instance pro třídu CIM konkrétního oboru názvů
Tento příklad získá instanci třídy CIM s názvem MSFT_Something v kořenovém adresáři oboru názvů nebo někde a uloží ji do proměnné s názvem $class. Proměnná se předá rutině New-CimInstance , která vytvoří novou instanci CIM a provede ověření na straně klienta v nové instanci.
V tomto příkladu použití parametru CimClass místo parametru ClassName ověří, že Prop1 a Prop2 skutečně existují a že klíče jsou označeny správně.
Parametr ComputerName nebo CimSession nelze použít s parametrem ClientOnly .
Parametry
-CimClass
Určuje objekt třídy CIM, který představuje typ instance. Pomocí rutiny Get-CimClass načtěte deklaraci třídy z počítače. Použití tohoto parametru vede k lepšímu ověření schématu na straně klienta.
Spustí příkaz pomocí zadané relace CIM. Zadejte proměnnou, která obsahuje relaci CIM, nebo příkaz, který relaci CIM vytvoří nebo získá, například pomocí cmdletů New-CimSession nebo Get-CimSession. Další informace naleznete v tématu about_CimSession.
Určuje název třídy CIM, pro kterou operace vytvoří instanci. POZNÁMKA: Pomocí dokončování tabulátoru můžete procházet seznam tříd, protože PowerShell získá seznam tříd z místního serveru WMI a poskytne seznam názvů tříd.
Označuje, že instance je vytvořena pouze v PowerShellu bez přechodu na server CIM. Tento parametr můžete použít k vytvoření instance CIM v paměti pro použití v následných operacích PowerShellu.
Určuje obor názvů třídy pro novou instanci. Výchozí obor názvů je root/cimv2.
Pomocí dokončování tabulátoru můžete procházet seznam oborů názvů, protože PowerShell získá seznam oborů názvů z místního serveru WMI a poskytne seznam oborů názvů.
Určuje dobu, po kterou rutina čeká na odpověď ze serveru CIM. Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server. Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, selhání sítě, která trvala více než hodnota parametru OperationTimeoutSec, není možné obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.
Určuje vlastnosti instance CIM pomocí tabulky hash (páry name-value).
Pokud zadáte parametr CimClass , New-CimInstance pak rutina provede ověření vlastnosti na klientovi, aby se zajistilo, že zadané vlastnosti jsou konzistentní s deklarací třídy na serveru. Pokud není zadán parametr CimClass , provede se ověření vlastnosti na serveru.
Určuje identifikátor URI (Uniform Resource Identifier) prostředku třídy prostředků nebo instance. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.
Identifikátor URI se skládá z předpony a cesty k prostředku. Například:
Pokud tento parametr nezadáte, použije se standardní identifikátor URI prostředku DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ a název třídy se k němu připojí.
ResourceURI lze použít pouze s relacemi CIM vytvořenými pomocí protokolu WSMan nebo při zadávání parametru ComputerName, který vytvoří relaci CIM pomocí WSManu. Pokud tento parametr zadáte bez zadání parametru ComputerName nebo pokud zadáte relaci CIM vytvořenou pomocí protokolu DCOM, zobrazí se chyba, protože protokol DCOM nepodporuje parametr ResourceURI.
Pokud je zadán parametr ResourceUri i parametr Filter, bude parametr filtru ignorován.
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.