Aracılığıyla paylaş

New-CimInstance

  • Başvuru
Modül:
CimCmdlets

Bir CIM örneği oluşturur.

Sözdizimi

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

cmdlet'i New-CimInstance , yerel bilgisayardaki veya uzak bilgisayardaki sınıf tanımına göre CIM sınıfının bir örneğini oluşturur. Varsayılan olarak, New-CimInstance cmdlet yerel bilgisayarda bir örnek oluşturur.

Örnekler

Örnek 1: CIM sınıfının bir örneğini oluşturma

Bu örnek, bilgisayardaki root/cimv2 ad alanında win32_environment adlı bir CIM Sınıfı örneği oluşturur.

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

Sınıf yoksa, özellikler yanlışsa veya sunucu çağrıyı reddederse istemci tarafı doğrulaması yapılmaz. Örnek başarıyla oluşturulursa, cmdlet yeni oluşturulan örneği verir.

Örnek 2: Sınıf şeması kullanarak CIM sınıfının bir örneğini oluşturma

Bu örnek bir CIM sınıf nesnesi alır ve adlı $classbir değişkende depolar. Değişkenin içeriği daha sonra cmdlet'ine New-CimInstance geçirilir.

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

Örnek 3: İstemcide dinamik örnek oluşturma

Bu örnek, örneği sunucudan almadan istemci bilgisayarda Win32_Process adlı bir CIM sınıfının dinamik örneğini oluşturur. Yeni örnek değişkeninde $adepolanır. Bu dinamik örnek, bu anahtara sahip örnek sunucuda varsa işlemleri gerçekleştirmek için kullanılabilir.

$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
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 :

Ardından Get-CimInstance cmdlet belirli bir tek örneği alır. Cmdlet, Invoke-CimMethod alınan örnekte GetOwner yöntemini çağırır.

Örnek 4: Belirli bir ad alanının CIM sınıfı için örnek oluşturma

Bu örnek, ad alanı kökünde/bir yerinde MSFT_Something adlı bir CIM sınıfının örneğini alır ve adlı $classbir değişkende depolar. Değişken, yeni bir CIM örneği oluşturmak ve yeni örnekte istemci tarafı doğrulamaları gerçekleştirmek için cmdlet'ine geçirilir New-CimInstance .

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

Bu örnekte, ClassName parametresi yerine CimClass parametresinin kullanılması Prop1 ve Prop2'nin gerçekten var olduğunu ve anahtarların doğru şekilde işaretlendiğini doğrular.

ClientOnly parametresiyle ComputerName veya CimSession parametresini kullanamazsınız.

Parametreler

-CimClass

Örneğin türünü temsil eden bir CIM sınıf nesnesi belirtir. Get-CimClass Bir bilgisayardan sınıf bildirimini almak için cmdlet'ini kullanın. Bu parametrenin kullanılması daha iyi istemci tarafı şema doğrulamalarıyla sonuçlanır.

Tür:CimClass
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-CimSession

Belirtilen CIM oturumunu kullanarak komutunu çalıştırır. CIM oturumunu içeren bir değişken veya VEYA cmdlet'leri gibi CIM oturumunu New-CimSession oluşturan veya Get-CimSession alan bir komut girin. Daha fazla bilgi için bkz . about_CimSession.

Tür:CimSession[]
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ClassName

İşlemin örnek oluşturduğu CIM sınıfının adını belirtir. NOT: PowerShell, sınıf adlarının listesini sağlamak için yerel WMI sunucusundan sınıfların listesini aldığından, sınıf listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ClientOnly

Örneğin CIM sunucusuna gitmeden yalnızca PowerShell'de oluşturulduğunu gösterir. Sonraki PowerShell işlemlerinde kullanılmak üzere bellek içi cim örneği oluşturmak için bu parametreyi kullanabilirsiniz.

Tür:SwitchParameter
Diğer adlar:Local
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ComputerName

CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam etki alanı adı (FQDN), NetBIOS adı veya IP adresi belirtebilirsiniz.

Bu parametreyi belirtirseniz, cmdlet WSMan protokolunu kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur.

Bu parametreyi belirtmezseniz, cmdlet işlemi Bileşen Nesne Modeli (COM) kullanarak yerel bilgisayarda gerçekleştirir.

Aynı bilgisayarda birden çok işlem gerçekleştiriliyorsa, CIM oturumu kullanarak bağlanmak daha iyi performans sağlar.

Tür:String[]
Diğer adlar:CN, ServerName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Key

Anahtar olarak kullanılan özellikleri belirtir. Anahtar belirtildiğinde CimSession ve ComputerName kullanılamaz.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Namespace

Yeni örneğin sınıfının ad alanını belirtir. Varsayılan ad alanı root/cimv2'dir. PowerShell, ad alanlarının listesini sağlamak üzere yerel WMI sunucusundan bir ad alanı listesi aldığından, ad alanları listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-OperationTimeoutSec

Cmdlet'in CIM sunucusundan yanıt bekleme süresini belirtir. Varsayılan olarak, bu parametrenin değeri 0'dır; bu da cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir. OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.

Tür:UInt32
Diğer adlar:OT
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Property

Karma tablo (ad-değer çiftleri) kullanarak CIM örneğinin özelliklerini belirtir.

CimClass parametresini belirtirseniz cmdlet, belirtilen özelliklerin New-CimInstance sunucudaki sınıf bildirimiyle tutarlı olduğundan emin olmak için istemcide bir özellik doğrulaması gerçekleştirir. CimClass parametresi belirtilmezse, özellik doğrulaması sunucuda yapılır.

Tür:IDictionary
Diğer adlar:Arguments
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceUri

Kaynak sınıfının veya örneğin kaynak tekdüzen kaynak tanımlayıcısını (URI) belirtir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.

URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:

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

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

Varsayılan olarak, bu parametreyi belirtmezseniz, DMTF standart kaynak URI'sini http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ kullanılır ve sınıf adı eklenir.

ResourceURI yalnızca WSMan protokolü kullanılarak oluşturulan CIM oturumlarıyla veya WSMan kullanarak cim oturumu oluşturan ComputerName parametresini belirtirken kullanılabilir. ComputerName parametresini belirtmeden bu parametreyi belirtirseniz veya DCOM protokolü kullanılarak oluşturulan bir CIM oturumu belirtirseniz, DCOM protokolü ResourceURI parametresini desteklemediğinden bir hata alırsınız.

Hem ResourceUri parametresi hem de Filter parametresi belirtilirse, Filter parametresi yoksayılır.

Tür:Uri
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

CimInstance

Bu cmdlet CIM örneği bilgilerini içeren bir nesne döndürür.

Notlar

PowerShell için aşağıdaki diğer adları New-CimInstanceiçerir:

  • Windows:
    • ncim

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.