Get-CMDevice
SYNOPSIS
Haal een Configuration Manager op.
SYNTAX
ByName (standaard)
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
De cmdlet Get-CMDevice haalt een Configuration Manager op. Standaard wordt een query op de SMS_CM_RES_COLL_SMS00001 opgevraagd. U kunt de parameters -Resource of -CollectionMember gebruiken om de queryklasse te wijzigen. Afhankelijk van uw op rollen gebaseerde toegang tot de site, moet u mogelijk een van deze andere parameters gebruiken.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Apparaten ophalen op verzamelings-id
Met deze opdracht worden alle apparaatobjecten in de apparaatverzameling met de id XYZ0004B ophaald. De cmdlet Select-Object wordt gebruikt om alleen specifieke eigenschappen weer te geven.
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
Voorbeeld 2: Apparaatbronnen ophalen op verzamelings-id
Deze opdracht is vergelijkbaar met het eerste voorbeeld, maar maakt gebruik van de parameter -Resource. Wanneer er een query wordt op een andere klasse, worden verschillende eigenschappen voor vergelijkbare gegevens retourneert.
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}
Voorbeeld 3: Eigenschappen voor een specifiek apparaat op halen
Met deze opdracht wordt een specifiek apparaat opgeslagen en wordt de uitvoer via de cmdlet Select-Object om alleen specifieke eigenschappen weer te geven. Omdat de parameter -Resource wordt gebruikt, zijn de eigenschappen specifiek voor die klasse.
Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses
Voorbeeld 4: Apparaten die geen clients zijn, op halen
Deze opdracht maakt gebruik van de -Fast parameter voor het krijgen van alle apparaten zonder luie eigenschappen. De lijst wordt gefilterd op alleen apparaten die geen clients zijn. In de uiteindelijke lijst wordt alleen de naam van het apparaat weergegeven.
Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name
Voorbeeld 5: Apparaten voor een specifieke bedreigingsnaam op halen
Met deze opdracht worden alle apparaten weer gegeven waarop Microsoft Defender een specifieke bedreiging heeft gedetecteerd. Er wordt alleen de naam van het apparaat weergegeven.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Voorbeeld 6: alle apparaten met gedetecteerde malware op halen
Met deze opdracht wordt eerst de cmdlet Get-CMDetectedMalware gebruikt om alle bedreigingen op te halen. Vervolgens wordt deze lijst geparseert en wordt de naam van apparaten met malware weergegeven.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Collection
Gebruik deze parameter om alle apparaten op te halen uit een apparaatverzamelingsobject. Gebruik de cmdlet Get-CMDeviceCollection om dit object op te halen.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Geef een id op voor een apparaatverzameling. Bijvoorbeeld 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
Voeg deze parameter toe om een query uit te voeren op SMS_R_UnknownSystem en SMS_R_System voor apparaatgegevens. Deze klassen kunnen worden beperkt door op rollen gebaseerde toegang. Deze klassen bevatten gedetailleerdere computergegevens.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Geef de naam van een apparaatverzameling op.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast
Voeg deze parameter toe om luie eigenschappen niet automatisch te vernieuwen. Luie eigenschappen bevatten waarden die relatief inefficiënt zijn om op te halen. Het verkrijgen van deze eigenschappen kan extra netwerkverkeer veroorzaken en de prestaties van de cmdlet verlagen.
Als u deze parameter niet gebruikt, geeft de cmdlet een waarschuwing weer. Als u deze waarschuwing wilt uitschakelen, stelt u $CMPSSuppressFastNotUsedCheck = $true in.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een gedetecteerd malwareobject op. Gebruik de cmdlet Get-CMDetectedMalware om dit object op te halen.
Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Geef de naam van een apparaat op.
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
Voeg deze parameter toe om een query uit te voeren SMS_Resource de klasse voor apparaatgegevens. Deze klasse mag niet worden beperkt door op rollen gebaseerde toegang. De uitvoer is hetzelfde als met de cmdlet Get-CMResource. Deze uitvoer heeft minimale eigenschappen voor het apparaat. Voor gedetailleerdere eigenschappen voegt u deze parameter niet toe of gebruikt u de parameter -CollectionMember.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Geef de resource-id van een apparaat op. Bijvoorbeeld 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
Gebruik deze parameter om de apparaten die worden teruggelaten naar die apparaten met specifieke malware te filteren op id. Bijvoorbeeld 2147735505. Gebruik de cmdlet Get-CMDetectedMalware om deze bedreigings-id op te halen.
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatName
Gebruik deze parameter om op naam de apparaten te filteren die worden terug naar die apparaten met specifieke malware. Bijvoorbeeld Trojan:Win32/Wacatac.B!ml. Gebruik de cmdlet Get-CMDetectedMalware om deze bedreigingsnaam op te halen.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.