New-CimInstance

Modul:: CimCmdlets Module

Vytvoří instanci CIM.

Syntaxe

ClassNameComputerSet (Výchozí)

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

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.

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

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.

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

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.

$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 :

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.

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

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.

Vlastnosti parametru

Typ:	CimClass
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

CimClassSessionSet

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CimClassComputerSet

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CimSession

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.

Vlastnosti parametru

Typ:	CimSession[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ClassNameSessionSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ResourceUriSessionSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CimClassSessionSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ClassName

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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ClassNameComputerSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ClassNameSessionSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ClientOnly

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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Místní

Sady parametrů

ClassNameComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ClassNameSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CimClassSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CimClassComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ComputerName

Určuje název počítače, na kterém chcete spustit operaci CIM. Můžete zadat plně kvalifikovaný název domény (FQDN), název NetBIOS nebo IP adresu.

Pokud zadáte tento parametr, rutina vytvoří dočasnou relaci se zadaným počítačem pomocí protokolu WSMan.

Pokud tento parametr nezadáte, rutina provede operaci na místním počítači pomocí modelu COM (Component Object Model).

Pokud se na stejném počítači provádí více operací, poskytuje připojení pomocí relace CIM lepší výkon.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Čína, Název serveru

Sady parametrů

ClassNameComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CimClassComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Key

Určuje vlastnosti, které se používají jako klíče. CimSession a ComputerName nelze použít při zadání klíče .

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ClassNameComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ClassNameSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Namespace

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ClassNameComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ClassNameSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriSessionSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-OperationTimeoutSec

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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OT

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Property

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.

Vlastnosti parametru

Typ:	IDictionary
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Argumenty

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceUri

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:

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

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

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.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ResourceUriSessionSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ResourceUriComputerSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

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.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

CimInstance

Tato rutina vrátí objekt, který obsahuje informace o instanci CIM.

Poznámky

PowerShell obsahuje následující aliasy pro New-CimInstance:

Windows:
- ncim

Tento cmdlet je dostupný pouze na platformách Windows.

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

New-CimInstance

Syntaxe

ClassNameComputerSet (Výchozí)

ClassNameSessionSet

ResourceUriSessionSet

ResourceUriComputerSet

CimClassSessionSet

CimClassComputerSet

Description

Příklady

Příklad 1: Vytvoření instance třídy CIM

Příklad 2: Vytvoření instance třídy CIM pomocí schématu třídy

Příklad 3: Vytvoření dynamické instance v klientovi

Příklad 4: Vytvoření instance pro třídu CIM konkrétního oboru názvů

Parametry

-CimClass

Vlastnosti parametru

Sady parametrů

-CimSession

Vlastnosti parametru

Sady parametrů

-ClassName

Vlastnosti parametru

Sady parametrů

-ClientOnly

Vlastnosti parametru

Sady parametrů

-ComputerName

Vlastnosti parametru

Sady parametrů

-Confirm

Vlastnosti parametru

Sady parametrů

-Key

Vlastnosti parametru

Sady parametrů

-Namespace

Vlastnosti parametru

Sady parametrů

-OperationTimeoutSec

Vlastnosti parametru

Sady parametrů

-Property

Vlastnosti parametru

Sady parametrů

-ResourceUri

Vlastnosti parametru

Sady parametrů

-WhatIf

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

None

Výstupy

CimInstance

Poznámky

Související odkazy

Váš názor