共用方式為

Get-CMCollectionMember

  • 參考
模組:
ConfigurationManager

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

語法

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：使用管線運算元取得集合的成員

此命令會先使用 Get-CMCollection Cmdlet 來取得名為 UserCol1 的集合物件。 然後，它會使用管線運算符將對象傳遞至 Get-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"。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-CollectionName

指定要查詢的集合名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

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

您也可以使用管線運算符 (|) ，將集合對象傳遞至命令行上的 Get-CMCollectionMemeber 。

類型:IResultObject
別名:Collection
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

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

您可以使用通配符：

  • *：多個字元
  • ?：單一字元
類型:String
別名:ResourceName
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-ResourceId

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

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SmsId

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

您可以使用通配符：

  • *：多個字元
  • ?：單一字元
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object