Get-CMDevice
SYNOPSIS
Hämta en Konfigurationshanteraren enhet.
SYNTAX
ByName (standard)
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
Cmdleten Get-CMDevice hämtar en Konfigurationshanteraren enhet. Som standard frågar den SMS_CM_RES_COLL_SMS00001 klassen. Du kan använda parametrarna -Resource eller -CollectionMember för att ändra frågeklassen. Beroende på din rollbaserade åtkomst på webbplatsen kan du behöva använda någon av dessa andra parametrar.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Hämta enheter efter samlings-ID
Det här kommandot hämtar alla enhetsobjekt i enhetssamlingen med ID:t för XYZ0004B. Den använder cmdleten Select-Object för att endast visa specifika egenskaper.
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
Exempel 2: Hämta enhetsresurser efter samlings-ID
Det här kommandot liknar det första exemplet, men använder parametern -Resource. När den frågar en annan klass returneras olika egenskaper för liknande data.
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}
Exempel 3: Hämta egenskaper för en specifik enhet
Det här kommandot hämtar en specifik enhet och kör utdata via cmdleten Select-Object för att endast visa specifika egenskaper. Eftersom den använder parametern -Resource är egenskaperna specifika för den klassen.
Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses
Exempel 4: Hämta enheter som inte är klienter
Det här kommandot använder parametern -Fast för att hämta alla enheter utan lazy-egenskaper. Den filtrerar listan till endast enheter som inte är klienter. Den visar bara enhetsnamnet i den slutliga listan.
Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name
Exempel 5: Hämta enheter för ett specifikt hotnamn
Det här kommandot visar alla enheter där Microsoft Defender har identifierat ett specifikt hot. Den visar bara namnet på enheten.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Exempel 6: Hämta alla enheter med eventuell upptäckt skadlig kod
Det här kommandot använder först cmdleten Get-CMDetectedMalware för att hämta alla hot. Den parsar sedan genom listan och visar namnet på enheter med skadlig kod.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Samling
Använd den här parametern för att hämta alla enheter från ett enhetssamlingsobjekt. Hämta det här objektet med cmdleten Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Ange ett ID för en enhetssamling. Till exempel 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
Lägg till den här parametern för att fråga SMS_R_UnknownSystem SMS_R_System om enhetsinformationen. Dessa klasser kan begränsas av rollbaserad åtkomst. Dessa klasser innehåller mer detaljerad datorinformation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange namnet på en enhetssamling.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snabb
Lägg till den här parametern för att inte uppdatera lazy-egenskaper automatiskt. Lazy-egenskaper innehåller värden som är relativt ineffektiva att hämta. Att hämta dessa egenskaper kan orsaka ytterligare nätverkstrafik och minska cmdlet-prestanda.
Om du inte använder den här parametern visar cmdleten en varning. Om du vill inaktivera den här varningen anger du $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett identifierat objekt för skadlig kod. Hämta det här objektet med hjälp av cmdleten 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
Ange namnet på en enhet.
Type: String
Parameter Sets: ByName, SearchByValueMandatory, SearchByIdMandatory, SearchByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Resurs
Lägg till den här parametern för att fråga SMS_Resource-klassen efter enhetsinformation. Den här klassen bör inte begränsas av rollbaserad åtkomst. Utdata är samma som med cmdleten Get-CMResource. Dessa utdata har minimala egenskaper för enheten. Om du vill ha mer detaljerade egenskaper ska du inte lägga till den här parametern eller använda parametern -CollectionMember.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Ange resurs-ID för en enhet. Till exempel 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
Använd den här parametern för att filtrera de enheter som den returnerar till dessa enheter med specifik skadlig kod efter ID. Till exempel 2147735505. Hämta det här hot-ID:t med hjälp av cmdleten 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
Använd den här parametern för att filtrera de enheter som den returnerar till dessa enheter med specifik skadlig kod efter namn. Till exempel Trojan:Win32/Wacatac.B!ml. Hämta det här hotnamnet med hjälp av cmdleten Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.