Sdílet prostřednictvím


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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_CombinedDeviceResources

IResultObject#SMS_CombinedDeviceResources

POZNÁMKY

Get-CMResource

Approve-CMDevice

Block-CMDevice

Get-CMDeviceCollection

Remove-CMDevice

Odblokování zařízení CMDevice