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.