Get-CMCollectionMember

參考

模組:: ConfigurationManager

取得裝置或使用者集合的成員。

Syntax

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

使用此 Cmdlet 可取得集合的成員。集合可以包含裝置或使用者，但不能同時包含兩者。當您查詢集合時，此 Cmdlet 會傳回所有成員的物件。

如需詳細資訊，請參閱 Configuration Manager 中的集合簡介。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。如需詳細資訊，請參閱快速入門。

範例

範例1：使用管線運算子取得集合的成員

此命令會先使用 CMCollection 指令程式 ，取得名為 UserCol1的集合物件。然後使用管線運算子將物件傳遞至 CMCollectionMember，這會取得集合中的所有成員。最後，此範例使用 Select-Object Cmdlet 來顯示成員名稱。

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

範例2：依名稱取得集合的成員

這個命令會查詢集合 DeviceCol1 中名稱開頭為的成員 domain 。星號 (*) 萬用字元會符合多個字元。因此，結果可以包含 "domain1" 或 "domain-controller" 等名稱。

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

範例3：將集合詳細資料匯出至 CSV

這個範例會在 XYZ0004B 裝置集合中查詢一組屬性，並將其儲存在變數中 $collMem。第二列會將資料轉換成逗號分隔值 (CSV) 格式，並輸出至檔案。

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

參數

-CollectionId

指定要查詢之集合的識別碼。例如，"XYZ0004B"。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

指定要查詢的集合名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。您無法將它與 ForceWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。您無法將它與 DisableWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要查詢的集合物件。若要取得集合物件，請使用下列 Cmdlet 之一：

您也可以使用管線運算子 (|) 將集合物件傳遞至命令列上的 CMCollectionMemeber 。

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

若要篩選結果，請指定資源識別碼。例如，16777242。此 Cmdlet 只會傳回目標集合中該資源的記錄。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SmsId

若要篩選結果，請指定資源的 SMSID。例如，"GUID:7a186367-7372-4841-889e-ba2e3aad1e85"。這個篩選不區分大小寫。

您可以使用萬用字元：

*：多個字元
?：單一字元

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-名稱

若要篩選結果，請指定集合中資源的名稱。這個篩選不區分大小寫。