Get-CMDevice

Cikk
08/12/2021

SYNOPSIS

Szerezze be Konfigurációkezelő eszközt.

SYNTAX

ByName (alapértelmezett)

Get-CMDevice [-CollectionMember] [-Fast] [-Name <String>] [-Resource] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

SearchByValueMandatory

Get-CMDevice -Collection <IResultObject> [-CollectionMember] [-Fast] [-Name <String>] [-Resource]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByIdMandatory

Get-CMDevice -CollectionId <String> [-CollectionMember] [-Fast] [-Name <String>] [-Resource]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByIdMandatoryForViewInfectedClients

Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByNameMandatoryForViewInfectedClients

Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByValueMandatoryForViewInfectedClients

Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] -InputObject <IResultObject> [-Resource]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByName Kötelező

Get-CMDevice [-CollectionMember] -CollectionName <String> [-Fast] [-Name <String>] [-Resource]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

ById (ById)

Get-CMDevice [-CollectionMember] [-Fast] [-Resource] -ResourceId <Int32> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

A Get-CMDevice parancsmag lekért egy Konfigurációkezelő eszközt. Alapértelmezés szerint lekérdezi a SMS_CM_RES_COLL_SMS00001 osztályt. A lekérdezési osztályt az -Resource vagy a -CollectionMember paraméterekkel módosíthatja. A hely szerepköralapú hozzáférésétől függően előfordulhat, hogy ezen paraméterek egyikére van szükség.

Megjegyzés

Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.

EXAMPLES

1. példa: Eszközök begyűjtése gyűjteményazonosító alapján

Ez a parancs lekérte az eszközgyűjtemény összes eszközobjektumát XYZ0004B azonosítóval. A Select-Object parancsmagot használja, hogy csak bizonyos tulajdonságokat jelenítsen meg.

Get-CMDevice -CollectionID "XYZ0004B" | Select-Object Name, ClientVersion, DeviceOS, IsActive, LastActiveTime, LastClientCheckTime, LastDDR, LastHardwareScan, LastPolicyRequest

Name                : DEVICE-LT3
ClientVersion       : 5.00.9012.1020
DeviceOS            : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive            : True
LastActiveTime      : 10/1/2020 23:29:34
LastClientCheckTime : 9/8/2020 18:38:10
LastDDR             : 9/30/2020 20:29:33
LastHardwareScan    : 9/30/2020 22:24:22
LastPolicyRequest   : 10/1/2020 23:29:34

Name                : DEVICE-LT2
ClientVersion       : 5.00.9030.1011
DeviceOS            : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive            : True
LastActiveTime      : 10/2/2020 00:31:54
LastClientCheckTime : 9/30/2020 23:06:10
LastDDR             : 9/30/2020 19:44:46
LastHardwareScan    : 9/30/2020 01:15:52
LastPolicyRequest   : 10/2/2020 00:31:54

2. példa: Eszközerőforrások begyűjtése gyűjteményazonosító alapján

Ez a parancs hasonló az első példához, de a -Resource paramétert használja. Ha egy másik osztályt lekérdezést ad vissza, a hasonló adatok különböző tulajdonságait adja vissza.

Get-CMDevice -CollectionID "XYZ0004B" -Resource | Select-Object Name, ClientVersion, OperatingSystemNameandVersion, Active, AgentName, AgentTime

Name                          : DEVICE-LT3
ClientVersion                 : 5.00.9012.1020
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active                        : 1
AgentName                     : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
                                MP_ClientRegistration, Heartbeat Discovery}
AgentTime                     : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 9/21/2020 15:53:47, 9/30/2020 13:29:33}

Name                          : DEVICE-LT2
ClientVersion                 : 5.00.9030.1011
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active                        : 1
AgentName                     : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
                                MP_ClientRegistration, Heartbeat Discovery}
AgentTime                     : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 10/1/2020 14:03:56, 9/30/2020 12:44:46}

3. példa: Egy adott eszköz tulajdonságainak lekért száma

Ez a parancs lekért egy adott eszközt, és a Select-Object parancsmaggal áttömi a kimenetet, hogy csak bizonyos tulajdonságokat mutasson. Mivel az -Resource paramétert használja, a tulajdonságok az adott osztályra vonatkoznak.

Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses

4. példa: Nem ügyféleszközök lekérte

Ez a parancs a -Fast paraméterrel lekért minden olyan eszközt, amely nem rendelkezik lusta tulajdonságokkal. A listát csak olyan eszközökre szűri, amelyek nem ügyfelek. Csak az eszköz nevét jeleníti meg a végső listában.

Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name

5. példa: Eszközök lekérte egy adott fenyegetés nevét

Ez a parancs megjeleníti az összes olyan eszközt, amelyen a Microsoft Defender egy adott fenyegetést észlelt. Csak az eszköz nevét jeleníti meg.

Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name

6. példa: Az észlelt kártevők minden eszközének lekért száma

Ez a parancs először a Get-CMDetectedMalware parancsmagot használja az összes fenyegetés lekérte. Ezután végig fog elemezni a listában, és megjeleníti a kártevővel fertőzött eszközök nevét.

$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }

PARAMETERS

-Collection (Gyűjtemény)

Ezzel a paraméterrel lekért minden eszközt egy eszközgyűjtemény-objektumból. Az objektum leolvasásához használja a Get-CMDeviceCollection parancsmagot.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-CollectionId (Gyűjteményazonosító)

Adja meg egy eszközgyűjtemény azonosítóját. Például: XYZ0004B.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

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

Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients, SearchByNameMandatoryForViewInfectedClients, SearchByValueMandatoryForViewInfectedClients
Aliases:

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

-CollectionMember

Adja hozzá ezt a paramétert a SMS_R_UnknownSystem és SMS_R_System eszközinformációk lekérdezéséhez. Ezek az osztályok szerepköralapú hozzáféréssel korlátozhatóak. Ezek az osztályok részletesebb számítógép-információkat tartalmaznak.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance

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

-CollectionName (Gyűjtemény neve)

Adja meg az eszközgyűjtemény nevét.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-DisableWildcardHandling

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Fast (Gyors)

Adja hozzá ezt a paramétert, hogy ne frissítse automatikusan a lusta tulajdonságokat. A lusta tulajdonságok olyan értékeket tartalmaznak, amelyek lekérése viszonylag nem hatékony. Ezeknek a tulajdonságoknak a beszerzése további hálózati forgalmat okozhat, és csökkentheti a parancsmagok teljesítményét.

Ha nem használja ezt a paramétert, a parancsmag figyelmeztetést jelenít meg. A figyelmeztetés letiltásához állítsa be a (Beállítás) $CMPSSuppressFastNotUsedCheck = $true halmazt.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Adjon meg egy észlelt kártevő objektumot. Az objektum lekérte a Get-CMDetectedMalware parancsmagot.

Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Adja meg az eszköz nevét.

Type: String
Parameter Sets: ByName, SearchByValueMandatory, SearchByIdMandatory, SearchByNameMandatory
Aliases:

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

-Resource (Erőforrás)

Adja hozzá ezt a paramétert a SMS_Resource osztály eszközinformációk lekérdezéséhez. Ezt az osztályt nem szabad szerepköralapú hozzáféréssel korlátozni. A kimenet ugyanaz, mint a Get-CMResource parancsmag kimenete. Ez a kimenet minimális tulajdonságokkal rendelkezik az eszközhöz. Részletesebb tulajdonságokért ne adja hozzá ezt a paramétert, vagy használja a -CollectionMember paramétert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance

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

-ResourceId (Erőforrás-id)

Adja meg egy eszköz erőforrás-azonosítóját. Például: 16780010.

Type: Int32
Parameter Sets: ById
Aliases: Id, DeviceId

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

-ThreatId (Fenyegetésazonosító)

Ezzel a paraméterrel az adott kártevők azonosító alapján szűrhetők az eszközökre visszaadott eszközök. Például: 2147735505. A fenyegetésazonosító lekérte a Get-CMDetectedMalware parancsmagot.

Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId

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

-ThreatName (Fenyegetés neve)

Ezzel a paraméterrel szűrheti az eszközökre visszaadott eszközöket meghatározott kártevők név alapján. Például: Trojan:Win32/Wacatac.B!ml. Ezt a fenyegetésnevet a Get-CMDetectedMalware parancsmag használatával használhatja.

Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_CombinedDeviceResources

IResultObject#SMS_CombinedDeviceResources

MEGJEGYZÉSEK

Get-CMResource

Approve-CMDevice (Parancsmag jóváhagyása)

Block-CMDevice (Blokk-CMDevice)

Get-CMDeviceCollection

Remove-CMDevice (Parancsmag eltávolítása)

A CMDevice feloldása

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