Get-CMDevice
SYNOPSIS
Bir Yapılandırma Yöneticisi edin.
SYNTAX
ByName (Varsayılan)
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
Get-CMDevice cmdlet'i bir Yapılandırma Yöneticisi alır. Varsayılan olarak, SMS_CM_RES_COLL_SMS00001 sorgular. Sorgu sınıfını değiştirmek için -Resource veya -CollectionMember parametrelerini kullanabilirsiniz. Sitede rol tabanlı erişiminize bağlı olarak, bu diğer parametrelerden birini kullanabilirsiniz.
Not
Yapılandırma Yöneticisi site sürücüsünden cmdlet'Yapılandırma Yöneticisi çalıştırın, örneğin PS XYZ:\> . Daha fazla bilgi için başlarken bölümüne bakın.
EXAMPLES
Örnek 1: Cihazları koleksiyon kimliğine göre al
Bu komut, XYZ0004B kimliğine sahip cihaz koleksiyonunda yer alan tüm cihaz nesnelerini alır. Yalnızca belirli özellikleri görüntülemek için Select-Object cmdlet'ini kullanır.
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
Örnek 2: Koleksiyon kimliğine göre cihaz kaynaklarını al
Bu komut ilk örnekle benzerdir, ancak -Resource parametresini kullanır. Farklı bir sınıfı sorgulasa, benzer veriler için farklı özellikler döndürür.
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}
Örnek 3: Belirli bir cihazın özelliklerini al
Bu komut belirli bir cihazı alır ve çıkışı Select-Object cmdlet'inden yalnızca belirli özellikleri gösterecek şekilde gösterir. -Resource parametresini kullandığından, özellikler bu sınıfa özeldir.
Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses
Örnek 4: İstemci olmayan cihazları al
Bu komut, yavaş özelliklere sahip olmayan tüm cihazları almak için -Fast parametresini kullanır. Listeyi yalnızca istemci olmayan cihazlara filtreler. Yalnızca son listede cihaz adını görüntüler.
Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name
Örnek 5: Belirli bir tehdit adı için cihaz al
Bu komut, Microsoft Defender'ın belirli bir tehdit algılamış olduğu tüm cihazları gösterir. Yalnızca cihazın adını görüntüler.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Örnek 6: Algılanan kötü amaçlı yazılımlara sahip tüm cihazları al
Bu komut öncelikle tüm tehditleri almak için Get-CMDetectedMalware cmdlet'ini kullanır. Ardından bu listeyi ayrıştırarak kötü amaçlı yazılıma sahip cihazların adını görüntüler.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Collection
Bir cihaz koleksiyonu nesnesinden tüm cihazları almak için bu parametreyi kullanın. Bu nesneyi almak için Get-CMDeviceCollection cmdlet'ini kullanın.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Cihaz koleksiyonu için bir kimlik belirtin. Örneğin, 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
Cihaz bilgilerine ilişkin SMS_R_UnknownSystem ve SMS_R_System sorgulamak için bu parametreyi ekleyin. Bu sınıflar rol tabanlı erişimle kısıtlanabilir. Bu sınıflar daha ayrıntılı makine bilgileri içerir.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Cihaz koleksiyonunun adını belirtin.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Bu parametre joker karakterleri değişmez karakter değerleri olarak kabul eder. ForceWildcardHandling ile birleştiresiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hızlı
Geç özellikleri otomatik olarak yenilemek için bu parametreyi ekleyin. Yavaş özellikler, nispeten verimsiz değerler içerir. Bu özellikleri almak ek ağ trafiğine neden olabilir ve cmdlet performansını düşürebilir.
Bu parametreyi kullanasanız, cmdlet bir uyarı görüntüler. Bu uyarıyı devre dışı bırakmak için ayarını $CMPSSuppressFastNotUsedCheck = $true ayarlayın.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). DisableWildcardHandling ile birleştiresiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Algılanan bir kötü amaçlı yazılım nesnesi belirtin. Bu nesneyi almak için Get-CMDetectedMalware cmdlet'ini kullanın.
Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Bir cihazın adını belirtin.
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
Cihaz bilgileri için bir SMS_Resource sorgulamak için bu parametreyi ekleyin. Bu sınıf rol tabanlı erişimle kısıtlanmamıştır. Çıktı, Get-CMResource cmdlet'iyle aynıdır. Bu çıkış, cihaz için minimum özelliklere sahiptir. Daha ayrıntılı özellikler için bu parametreyi ekleme veya -CollectionMember parametresini kullanma.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Bir cihazın kaynak kimliğini belirtin. Örneğin, 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
Kimliğine göre belirli kötü amaçlı yazılımlara sahip cihazlara döndüren cihazları filtrelemek için bu parametreyi kullanın. Örneğin, 2147735505. Bu tehdit kimliğini almak için Get-CMDetectedMalware cmdlet'ini kullanın.
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatName
Bu parametreyi, belirli kötü amaçlı yazılımlara sahip cihazlara döndüren cihazları adla filtrelemek için kullanın. Örneğin, Trojan:Win32/Wacatac.B!ml. Bu tehdit adını almak için Get-CMDetectedMalware cmdlet'ini kullanın.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.