Partilhar via


Get-CMCollectionMember

SYNOPSIS

Arranja membros de uma coleção.

SYNTAX

ByCollectionName (Padrão)

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

ByCollectionId

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

ByCollection

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

DESCRIPTION

O Cm-CMCollectionMember cmdlet recebe membros de uma coleção de Gestor de Configuraçã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. Pode filtrar os resultados com base no nome ou identificação. Utilize este cmdlet para fazer uma consulta para dispositivos ou utilizadores a uma recolha específica.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Obter um membro de uma coleção utilizando o operador do gasoduto

Este comando utiliza primeiro o cmdlet Get-CMCollection para obter o objeto de coleção denominado UserCol1. Em seguida, utiliza o operador do gasoduto para passar o objeto para Get-CMCollectionMember, que recebe todos os membros no UserCol1. Finalmente, este exemplo utiliza o cmdlet Select-Object para apenas exibir 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 tenham um nome que comece por domain . O wildcard * () wildcard combina com vários caracteres. Assim, os resultados podem incluir nomes como "domain1" ou "domain-controller".

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

Exemplo 3: Detalhes da recolha de exportação para um CSV

Este exemplo consulta a coleção de dispositivos XYZ0004B para um conjunto de propriedades e lojas que na variável, $collMem. A segunda linha converte esses dados em formato de valor separado de vírgula (CSV) e saídas para um 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"

PARAMETERS

-CollectionId

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

Type: String
Parameter Sets: ByCollectionId
Aliases:

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

-Nome de coleção

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

Type: String
Parameter Sets: ByCollectionName
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Especifique um objeto de coleção para consulta. Para obter um objeto de recolha, utilize um dos seguintes cmdlets:

Também pode utilizar o operador do gasoduto | para passar um objeto de recolha para Get-CMCollectionMememeber na linha de comando.

Type: IResultObject
Parameter Sets: ByCollection
Aliases: Collection

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Para filtrar os resultados, especifique o nome de um recurso na recolha. Este filtro não é sensível a casos.

Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única
Type: String
Parameter Sets: (All)
Aliases: ResourceName

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

-ResourceId

Para filtrar os resultados, especifique um ID de recurso. Por exemplo, 16777242. O cmdlet apenas devolve um registo desse recurso na recolha visada.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
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". Este filtro não é sensível a casos.

Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única
Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Get-CMCollection

Get-CMDeviceCollection

Get-CMUserCollection

Get-CMDevice

Get-CMResource