Get-WmiObject

Referencia

Modul:: Microsoft.PowerShell.Management

Lekéri a Windows Management Instrumentation (WMI) osztályok példányait vagy az elérhető osztályokra vonatkozó információkat.

Syntax

Get-WmiObject
   [-Class] <String>
   [[-Property] <String[]>]
   [-Filter <String>]
   [-Amended]
   [-DirectRead]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [[-Class] <String>]
   [-Recurse]
   [-Amended]
   [-List]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-DirectRead]
   -Query <String>
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Description

A PowerShell 3.0-tól kezdve ezt a parancsmagot a rendszer felülírta Get-CimInstance.

A Get-WmiObject parancsmag lekéri a WMI-osztályok példányait vagy az elérhető WMI-osztályokra vonatkozó információkat. Távoli számítógép megadásához használja a ComputerName paramétert. Ha a List paraméter meg van adva, a parancsmag információt kap a megadott névtérben elérhető WMI-osztályokról. Ha a Lekérdezés paraméter meg van adva, a parancsmag egy WMI lekérdezési nyelv (WQL) utasítást futtat.

A Get-WmiObject parancsmag nem használja a Windows PowerShell-remoting parancsmagot a távoli műveletek végrehajtásához. A parancsmag ComputerName paraméterét Get-WmiObject akkor is használhatja, ha a számítógép nem felel meg a Windows PowerShell-újraküldésre vonatkozó követelményeknek, vagy nincs konfigurálva a Windows PowerShellben való újramotálásra.

A Windows PowerShell 3.0-tól kezdődően a visszaadott objektum Get-WmiObject __Server tulajdonsága PSComputerName aliassal rendelkezik. Így könnyebben felveheti a forrásszámítógép nevét a kimenetbe és a jelentésekbe.

Példák

1. példa: Folyamatok lekérése a helyi számítógépen

Ez a példa lekéri a folyamatokat a helyi számítógépen.

Get-WmiObject -Class Win32_Process

2. példa: Szolgáltatások lekérdezése távoli számítógépen

Ez a példa lekéri a szolgáltatásokat egy távoli számítógépen. A ComputerName paraméter egy távoli számítógép IP-címét adja meg. Alapértelmezés szerint az aktuális felhasználói fióknak a távoli számítógépen található Rendszergazda istrators csoport tagjának kell lennie.

Get-WmiObject -Class Win32_Service -ComputerName 10.1.4.62

3. példa: WMI-osztályok lekérése a helyi számítógép gyökér- vagy alapértelmezett névterében

Ez a példa beolvasja a WMI-osztályokat a helyi számítógép gyökér- vagy alapértelmezett névterébe.

Get-WmiObject -Namespace "root/default" -List

4. példa: Névvel ellátott szolgáltatás lekérése több számítógépen

Ez a példa lekéri a WinRM szolgáltatást a ComputerName paraméter értéke által megadott számítógépeken.

Get-WmiObject -Query "select * from win32_service where name='WinRM'" -ComputerName Server01, Server02 |
  Format-List -Property PSComputerName, Name, ExitCode, Name, ProcessID, StartMode, State, Status

PSComputerName : SERVER01
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 844
StartMode      : Auto
State          : Running
Status         : OK

PSComputerName : SERVER02
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 932
StartMode      : Auto
State          : Running
Status         : OK

A folyamatkezelő (|) elküldi a kimenetet a Format-List parancsmagnak, amely hozzáadja a PSComputerName tulajdonságot az alapértelmezett kimenethez. A PSComputerName a visszaadott objektumok Get-WmiObject __Server tulajdonságának aliasa. Ezt az aliast a PowerShell 3.0-ban vezettük be.

5. példa: Szolgáltatás leállítása távoli számítógépen

Ez a példa leállítja a WinRM szolgáltatást egy távoli számítógépen. Get-WmiObject lekéri a WinRM szolgáltatásobjektum példányát a Server01-en. Ezután meghívja a Win32_Service WMI-osztály StopService metódusát az objektumon.

(Get-WmiObject -Class Win32_Service -Filter "name='WinRM'" -ComputerName Server01).StopService()

Ez egyenértékű a Stop-Service parancsmag használatával.

6. példa: A BIOS lekérése a helyi számítógépen

Ez a példa lekéri a BIOS-adatokat a helyi számítógépről. A parancsmag Tulajdonság paramétere a Format-List visszaadott objektum összes tulajdonságának megjelenítésére szolgál egy listában. Alapértelmezés szerint csak a konfigurációs fájlban Types.ps1xml meghatározott tulajdonságok részhalmaza jelenik meg.

Get-WmiObject -Class Win32_Bios | Format-List -Property *

Status                : OK
Name                  : Phoenix ROM BIOS PLUS Version 1.10 A05
Caption               : Phoenix ROM BIOS PLUS Version 1.10 A05
SMBIOSPresent         : True
__GENUS               : 2
__CLASS               : Win32_BIOS
__SUPERCLASS          : CIM_BIOSElement
__DYNASTY             : CIM_ManagedSystemElement
__RELPATH             : Win32_BIOS.Name="Phoenix ROM BIOS PLUS Version 1.10
__PROPERTY_COUNT      : 27
__DERIVATION          : {CIM_BIOSElement, CIM_SoftwareElement, CIM_LogicalElement,
__SERVER              : Server01
__NAMESPACE           : root\cimv2
__PATH                : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
BiosCharacteristics   : {7, 9, 10, 11...}
BIOSVersion           : {DELL   - 15, Phoenix ROM BIOS PLUS Version 1.10 A05}
BuildNumber           :
CodeSet               :
CurrentLanguage       : en|US|iso8859-1
Description           : Phoenix ROM BIOS PLUS Version 1.10 A05
IdentificationCode    :
InstallableLanguages  : 1
InstallDate           :
LanguageEdition       :
ListOfLanguages       : {en|US|iso8859-1}
Manufacturer          : Dell Inc.
OtherTargetOS         :
PrimaryBIOS           : True
ReleaseDate           : 20101103000000.000000+000
SerialNumber          : 8VDM9P1
SMBIOSBIOSVersion     : A05
SMBIOSMajorVersion    : 2
SMBIOSMinorVersion    : 6
SoftwareElementID     : Phoenix ROM BIOS PLUS Version 1.10 A05
SoftwareElementState  : 3
TargetOperatingSystem : 0
Version               : DELL   - 15
Scope                 : System.Management.ManagementScope
Path                  : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
Options               : System.Management.ObjectGetOptions
ClassPath             : \\JUNE-PC\root\cimv2:Win32_BIOS
Properties            : {BiosCharacteristics, BIOSVersion, BuildNumber, Caption...}
SystemProperties      : {__GENUS, __CLASS, __SUPERCLASS, __DYNASTY...}
Qualifiers            : {dynamic, Locale, provider, UUID}
Site                  :
Container             :

7. példa: Szolgáltatások lekérése távoli számítógépen

Ez a példa a parancsmag Hitelesítő paraméterét használja a Get-WmiObject szolgáltatások távoli számítógépen való lekéréséhez. A hitelesítőadat-paraméter értéke egy felhasználói fiók neve. A rendszer jelszót kér a felhasználótól.

Get-WmiObject Win32_Service -Credential FABRIKAM\administrator -ComputerName Fabrikam

Feljegyzés

A hitelesítő adatok nem használhatók a helyi számítógép megcélzásakor.

Paraméterek

-Amended

Lekéri vagy beállít egy értéket, amely jelzi, hogy a WMI-ből visszaadott objektumoknak módosított információkat kell-e tartalmazniuk. A módosított információk általában honosítható információk, például objektum- és tulajdonságleírások, amelyek a WMI-objektumhoz vannak csatolva.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

A parancsot háttérfeladatként futtatja. Ezzel a paraméterrel olyan parancsokat futtathat, amelyek végrehajtása hosszú időt vesz igénybe.

Az AsJob paraméter használatakor a parancs egy olyan objektumot ad vissza, amely a háttérfeladatot jelöli, majd megjeleníti a parancssort. Folytathatja a munkát a munkamenetben, amíg a feladat befejeződik. Ha Get-WmiObject a ComputerName paraméterrel használják, a feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat kezeléséhez használja a főnevet tartalmazó Job parancsmagokat. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.

További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Megadja a WMI-kapcsolathoz használandó hitelesítési szintet. Az érvényes értékek a következők:

-1: Változatlan
0: Alapértelmezett
1: Nincs (Nincs hitelesítés végrehajtva.)
2: Csatlakozás (A hitelesítés csak akkor történik, ha az ügyfél kapcsolatot létesít az alkalmazással.)
3: Hívás (A hitelesítés csak az egyes hívások elején történik, amikor az alkalmazás megkapja a kérést.)
4: Csomag (A hitelesítés az ügyféltől kapott összes adaton történik.)
5: PacketIntegrity (Az ügyfél és az alkalmazás között továbbított összes adat hitelesítése és ellenőrzése.)
6: PacketPrivacy (A rendszer a többi hitelesítési szint tulajdonságait használja, és az összes adat titkosítva van.)

Type:	AuthenticationLevel
Accepted values:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authority

Megadja a WMI-kapcsolat hitelesítéséhez használni kívánt szolgáltatót. Megadhat standard NTLM- vagy Kerberos-hitelesítést. Az NTLM használatához állítsa be a szolgáltatói beállítást ntlmdomain:<DomainName>, ahol <DomainName> érvényes NTLM-tartománynevet azonosít. A Kerberos használatához adja meg a .kerberos:<DomainName>\<ServerName> A helyi számítógéphez való csatlakozáskor nem vehet fel szolgáltatói beállítást.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Class

Egy WMI-osztály nevét adja meg. Ha ezt a paramétert használja, a parancsmag lekéri a WMI-osztály példányait.

Type:	String
Aliases:	ClassName
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Megadja a felügyeleti művelet célszámítógépét. Adjon meg egy teljes tartománynevet (FQDN), netBIOS-nevet vagy IP-címet. Ha a távoli számítógép más tartományban van, mint a helyi számítógép, a teljes tartománynévre van szükség.

Alapértelmezés szerint a helyi számítógép. Ha meg szeretné adni a helyi számítógépet, például a számítógépnevek listájában, használja localhosta helyi számítógép nevét vagy egy pont (.) értéket.

Távoli számítógép megadásakor az aktuális fióknak vagy a hitelesítőadat-paraméterrel megadott fióknak megfelelő engedélyekkel kell rendelkeznie az információk eléréséhez.

Ez a paraméter nem támaszkodik a WS-Managementet használó Windows PowerShell-remotingra. Akkor is használhatja a ComputerName paramétert Get-WmiObject , ha a számítógép nincs konfigurálva a WS-Management távoli parancsok futtatására.

Type:	String[]
Aliases:	Cn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint az aktuális felhasználó. Írjon be egy felhasználónevet, például User01: , Domain01\User01vagy User@Contoso.com. Vagy írjon be egy PSCredential objektumot, például egy olyan objektumot, amelyet a Get-Credential parancsmag ad vissza. Amikor beír egy felhasználónevet, a rendszer jelszót kér. A hitelesítő adatok nem használhatók a helyi számítógép megcélzásakor.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectRead

Megadja, hogy a WMI-szolgáltató közvetlen hozzáférése kérhető-e a megadott osztályhoz az alaposztályra vagy a származtatott osztályokra való tekintet nélkül.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAllPrivileges

Engedélyezi az aktuális felhasználó összes jogosultságát, mielőtt a parancs meghívja a WMI-hívást.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Megadja a where záradékot, amelyet szűrőként kell használni. A WMI lekérdezési nyelv (WQL) szintaxisát használja.

Fontos

Ne adja meg a Where kulcsszót a paraméter értékében. Az alábbi parancsok például csak a DeviceID c: azonosítóval rendelkező logikai lemezeket és a "WinRM" nevű szolgáltatásokat a Where kulcsszó használata nélkül adják vissza.

Get-WmiObject Win32_LogicalDisk -filter "DeviceID = 'c:' "

Get-WmiObject win32_service -filter "name='WinRM'"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Impersonation

Megadja a használni kívánt megszemélyesítési szintet.

A paraméter elfogadható értékei a következők:

0: Alapértelmezett. Beolvassa a helyi beállításjegyzéket az alapértelmezett megszemélyesítési szinthez. Az alapértelmezett beállítás általában megszemélyesítés.
1: Névtelen. Elrejti a hívó hitelesítő adatait.
2: Azonosítás. Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
3: Megszemélyesítés. Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
4: Meghatalmazott. Lehetővé teszi, hogy az objektumok más objektumok számára is lehetővé tegyék a hívó hitelesítő adatainak használatát.

Type:	ImpersonationLevel
Accepted values:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-List

Lekéri a WMI-osztályok nevét a WMI-adattár névterében, amelyet a Névtér paraméter határoz meg.

Ha a List paramétert adja meg, a Névtér paramétert azonban nem, Get-WmiObject alapértelmezés szerint a Root\Cimv2 névteret használja. Ez a parancsmag nem használja a beállításkulcs alapértelmezett névtérregisztrációs bejegyzését HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WBEM\Scripting az alapértelmezett névtér meghatározásához.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Locale

A WMI-objektumok előnyben részesített területi beállítását adja meg. Adjon meg egy értéket MS_<LCID> formátumban.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Namespace

Az Osztály paraméter használatakor a Névtér paraméter megadja azt a WMI-adattár névterét, ahol a megadott WMI-osztály található. Ha a List paraméterrel használja, megadja azt a névteret, amelyből WMI-osztályinformációkat gyűjthet.

Type:	String
Aliases:	NS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Megadja azokat a WMI-osztálytulajdonságokat, amelyekből ez a parancsmag információt kap. Adja meg a tulajdonságneveket.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

A megadott WMI-lekérdezési nyelv (WQL) utasítást futtatja. Ez a paraméter nem támogatja az esemény-lekérdezéseket.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Recurse

Megkeresi az aktuális névteret és az összes többi névteret az Osztály paraméter által megadott osztálynévben.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottleLimit

Meghatározza az egyidejűleg végrehajtható WMI-műveletek maximális számát. Ez a paraméter csak akkor érvényes, ha az AsJob paramétert használja a parancs.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Bevitelek

None

A bemenő adatokat nem lehet becsúszni.Get-WmiObject

Kimenetek

PSObject or System.Management.Automation.RemotingJob

Az AsJob paraméter használatakor a parancsmag egy feladatobjektumot ad vissza. Ellenkező esetben a visszaadott Get-WmiObject objektum az Osztály paraméter értékétől függ.

Jegyzetek

A Windows PowerShell a következő aliasokat Get-WmiObjecttartalmazza:

gwmi

A WMI-információk távoli számítógépen való eléréséhez a parancsmagnak egy olyan fiók alatt kell futnia, amely a távoli számítógépen a helyi rendszergazdák csoportjának tagja. Vagy a távoli tárház WMI-névterének alapértelmezett hozzáférés-vezérlése módosítható úgy, hogy hozzáférési jogosultságokat adjon más fiókoknak.

Alapértelmezés szerint csak az egyes WMI-osztályok tulajdonságainak egy része jelenik meg. Az egyes WMI-osztályokhoz megjelenített tulajdonságok halmaza a Types.ps1xml konfigurációs fájlban van megadva. A WMI-objektumok összes tulajdonságának lekéréséhez használja a parancsmagokat vagy Format-List parancsmagokatGet-Member.

Megosztás a következőn keresztül:

Get-WmiObject

Syntax

Description

Példák

1. példa: Folyamatok lekérése a helyi számítógépen

2. példa: Szolgáltatások lekérdezése távoli számítógépen

3. példa: WMI-osztályok lekérése a helyi számítógép gyökér- vagy alapértelmezett névterében

4. példa: Névvel ellátott szolgáltatás lekérése több számítógépen

5. példa: Szolgáltatás leállítása távoli számítógépen

6. példa: A BIOS lekérése a helyi számítógépen

7. példa: Szolgáltatások lekérése távoli számítógépen

Paraméterek

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

Bevitelek

Kimenetek

Jegyzetek

Visszajelzés

További források

Megosztás a következőn keresztül:

Get-WmiObject

Syntax

Description

Példák

1. példa: Folyamatok lekérése a helyi számítógépen

2. példa: Szolgáltatások lekérdezése távoli számítógépen

3. példa: WMI-osztályok lekérése a helyi számítógép gyökér- vagy alapértelmezett névterében

4. példa: Névvel ellátott szolgáltatás lekérése több számítógépen

5. példa: Szolgáltatás leállítása távoli számítógépen

6. példa: A BIOS lekérése a helyi számítógépen

7. példa: Szolgáltatások lekérése távoli számítógépen

Paraméterek

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

További források