Get-CMCollectionMember

Referência

Módulo:: ConfigurationManager

Obter membros de um dispositivo ou coleção de usuários.

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

Use este cmdlet para obter membros de uma coleção. Coleções podem incluir dispositivos ou usuários, mas não ambos. Quando você consulta uma coleção, este cmdlet retorna objetos para todos os membros.

Para obter mais informações, consulte Introdução a coleções no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Obter um membro de uma coleção usando o operador de pipeline

Este comando usa primeiro o cmdlet Get-CMCollection para obter o objeto da coleção chamado UserCol1. Em seguida, ele usa o operador de pipeline para passar o objeto para Get-CMCollectionMember, que obtém todos os membros da coleção. Por fim, este exemplo usa o cmdlet Select-Object para exibir apenas os nomes de membros.

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

Exemplo 2: Obter um membro de uma coleção pelo nome

Este comando consulta a coleção DeviceCol1 para membros que têm um nome começando com domain . O caractere curinga asterisco ( * ) corresponde a vários caracteres. Portanto, os resultados podem incluir nomes como "domínio1" ou "controlador de domínio".

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

Exemplo 3: Exportar detalhes da coleção para um CSV

Este exemplo consulta a coleção de dispositivos XYZ0004B para um conjunto de propriedades e armazenamentos que, na variável, $collMem . A segunda linha converte esses dados em formato CSV (valor separado por vírgula) e as saídas em um arquivo.

$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"

Parâmetros

-CollectionId

Especifique a ID de uma coleção para consulta. Por exemplo, "XYZ0004B".

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

-CollectionName

Especifique o nome de uma coleção para consulta.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de coleção a ser consultado. Para obter um objeto de coleção, use um dos seguintes cmdlets:

Você também pode usar o operador de pipeline ( ) para passar um objeto de coleção | para Get-CMCollectionMemeber na linha de comando.

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

-Name

Para filtrar os resultados, especifique o nome de um recurso na coleção. Esse filtro não é sensível a minúsculas.

Você pode usar caracteres curinga:

*: Vários caracteres
?: Caractere único

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

-ResourceId

Para filtrar os resultados, especifique uma ID de recurso. Por exemplo, 16777242. O cmdlet retorna apenas um registro para esse recurso na coleção direcionada.

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

-SmsId

Para filtrar os resultados, especifique o SMSID de um recurso. Por exemplo, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Esse filtro não é sensível a minúsculas.