Get-CMDevice
SYNOPSIS
Získejte Správce konfigurace zařízení.
SYNTAX
ByName (výchozí)
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>]
SearchByNameMandatory
Get-CMDevice [-CollectionMember] -CollectionName <String> [-Fast] [-Name <String>] [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ById
Get-CMDevice [-CollectionMember] [-Fast] [-Resource] -ResourceId <Int32> [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Rutina Get-CMDevice získá Správce konfigurace zařízení. Ve výchozím nastavení se dotazuje SMS_CM_RES_COLL_SMS00001 třídy. Ke změně třídy dotazu můžete použít parametry -Resource nebo -CollectionMember. V závislosti na vašem přístupu na základě role v lokalitě možná budete muset použít jeden z těchto dalších parametrů.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Získání zařízení podle ID kolekce
Tento příkaz načte všechny objekty zařízení v kolekci zařízení s ID XYZ0004B. K zobrazení konkrétních vlastností používá rutinu Select-Object.
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
Příklad 2: Získání prostředků zařízení podle ID kolekce
Tento příkaz je podobný prvnímu příkladu, ale používá parametr -Resource. Když se dotazuje na jinou třídu, vrátí pro podobná data různé vlastnosti.
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}
Příklad 3: Získání vlastností pro konkrétní zařízení
Tento příkaz získá konkrétní zařízení a předá výstup prostřednictvím rutiny Select-Object tak, aby se zobrazují pouze konkrétní vlastnosti. Vzhledem k tomu, že používá parametr -Resource, jsou vlastnosti specifické pro tuto třídu.
Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses
Příklad 4: Získání zařízení, která nejsou klienty
Tento příkaz používá parametr -Fast k získání všech zařízení bez opožděných vlastností. Filtruje seznam jenom na zařízení, která nejsou klienty. Zobrazí se jenom název zařízení v posledním seznamu.
Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name
Příklad 5: Získání zařízení pro konkrétní název hrozby
Tento příkaz zobrazí všechna zařízení, na kterých Microsoft Defender zjistil konkrétní hrozbu. Zobrazuje jenom název zařízení.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Příklad 6: Získání všech zařízení s zjištěný malwarem
Tento příkaz nejprve pomocí rutiny Get-CMDetectedMalware zobrazí všechny hrozby. Pak tento seznam analyzuje a zobrazí název zařízení s malwarem.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Collection
Tento parametr použijte k získání všech zařízení z objektu kolekce zařízení. K získání tohoto objektu použijte rutinu Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Zadejte ID kolekce zařízení. Například, 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
Přidejte tento parametr pro dotazování SMS_R_UnknownSystem a SMS_R_System třídy pro informace o zařízení. Tyto třídy mohou být omezeny přístupem na základě role. Tyto třídy obsahují podrobnější informace o počítači.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Zadejte název kolekce zařízení.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast
Přidáním tohoto parametru se nebudou automaticky aktualizovat opožděné vlastnosti. Opožděné vlastnosti obsahují hodnoty, které jsou relativně neefektivní k načtení. Získání těchto vlastností může způsobit další síťový provoz a snížit výkon rutin.
Pokud tento parametr použijete, rutina zobrazí upozornění. Pokud chcete toto upozornění zakázat, nastavte $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Zadejte zjištěný objekt malwaru. K získání tohoto objektu použijte rutinu Get-CMDetectedMalware.
Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Zadejte název zařízení.
Type: String
Parameter Sets: ByName, SearchByValueMandatory, SearchByIdMandatory, SearchByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Prostředek
Přidejte tento parametr pro dotazování SMS_Resource třídy pro informace o zařízení. Tato třída by neměla být omezena přístupem na základě role. Výstup je stejný jako u rutiny Get-CMResource. Tento výstup má minimální vlastnosti zařízení. Pokud chcete zobrazit podrobnější vlastnosti, přidejte tento parametr nebo použijte parametr -CollectionMember.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Zadejte ID prostředku zařízení. Například, 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
Tento parametr slouží k filtrování zařízení, která se do těchto zařízení vrací, pomocí konkrétního malwaru podle ID. Například, 2147735505. K získání tohoto ID hrozby použijte rutinu Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatName
Pomocí tohoto parametru můžete filtrovat zařízení, která se do těchto zařízení vrací, pomocí konkrétního malwaru podle názvu. Například, Trojan:Win32/Wacatac.B!ml. K získání tohoto názvu hrozby použijte rutinu Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.