Get-CMCollection
Obtenha um dispositivo ou objeto de coleção de usuários.
Sintaxe
Get-CMCollection
[-CollectionType <CollectionType>]
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Use este cmdlet para obter um dispositivo ou objeto de coleção de usuários.
As coleções ajudam a organizar recursos em unidades gerenciáveis. Você pode criar coleções para atender às suas necessidades de gerenciamento de cliente e executar operações em vários recursos ao mesmo tempo. A maioria das tarefas de gerenciamento depende ou requer o uso de uma ou mais coleções.
Para escopo do tipo de coleção que você obtém, use os cmdlets Get-CMDeviceCollection ou Get-CMUserCollection .
Se você não especificar uma coleção por nome, ID ou objeto, este cmdlet retornará todas as coleções.
Para obter mais informações, consulte Introdução a coleções em Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: Obter uma coleção pelo nome
Esse comando obtém a coleção chamada testUser.
Get-CMCollection -Name "testUser"
Exemplo 2: Obter uma coleção para um grupo de pontos de distribuição
Esse comando obtém o objeto de grupo de pontos de distribuição chamado dpg1 e usa o operador de pipeline para passar o objeto para Get-CMCollection, que obtém as coleções associadas ao grupo de pontos de distribuição.
Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection
Quando você distribui conteúdo para essas coleções, o site distribui automaticamente para todos os membros atuais desse grupo de pontos de distribuição. Para obter mais informações, consulte Gerenciar grupos de pontos de distribuição.
Parâmetros
-CollectionType
Filtre o tipo de coleção a ser obtido. Esse parâmetro é funcionalmente o mesmo que usar os cmdlets Get-CMDeviceCollection ou Get-CMUserCollection .
Tipo: | CollectionType |
Valores aceitos: | User, Device |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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 |
-DistributionPointGroup
Especifique um objeto de grupo de pontos de distribuição associado a essa coleção. Para obter esse objeto, use o cmdlet Get-CMDistributionPointGroup .
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DistributionPointGroupId
Especifique o GUID para um grupo de pontos de distribuição associado a essa coleção. Esse valor é a propriedade GroupID , que é um GUID padrão cercado por colchetes encaracolados, por exemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352}
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DistributionPointGroupName
Especifique o nome de um grupo de pontos de distribuição associado a essa coleção.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 |
-Id
Especifique a ID da coleção a ser obtido. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012
ou SMS00001
.
Tipo: | String |
Aliases: | CollectionId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifique o nome da coleção a ser obtido.
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
IResultObject[]
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Collection classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de