Compartilhar via

Get-CMCollectionMember

  • Referência
Módulo:
ConfigurationManager

Obter membros de uma coleção de dispositivos ou utilizadores.

Sintaxe

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

Utilize este cmdlet para obter membros de uma coleção. As coleções podem incluir dispositivos ou utilizadores, mas não ambos. Quando consulta uma coleção, este cmdlet devolve objetos para todos os membros.

Para obter mais informações, veja Introdução às coleções no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

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

Este comando utiliza primeiro o cmdlet Get-CMCollection para obter o objeto de coleção denominado UserCol1. Em seguida, utiliza o operador de pipeline para transmitir o objeto para Get-CMCollectionMember, que obtém todos os membros na coleção. Por fim, este exemplo utiliza o cmdlet Select-Object para apresentar apenas os nomes dos 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 que começa com domain. O caráter universal asterisco (*) corresponde a múltiplos carateres. Assim, os resultados podem incluir nomes como "domain1" ou "domain-controller".

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 armazena-o na variável $collMem. A segunda linha converte esses dados em formato de valores separados por vírgulas (CSV) e produz num ficheiro.

$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 o ID de uma coleção a consultar. Por exemplo, "XYZ0004B".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique o nome de uma coleção a consultar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de coleção a consultar. Para obter um objeto de coleção, utilize um dos seguintes cmdlets:

Também pode utilizar o operador de pipeline (|) para transmitir um objeto de coleção para Get-CMCollectionMemeber na linha de comandos.

Tipo:IResultObject
Aliases:Collection
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Aliases:ResourceName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-ResourceId

Para filtrar os resultados, especifique um ID de recurso. Por exemplo, 16777242. O cmdlet devolve apenas um registo para esse recurso na coleção de destino.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SmsId

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

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object