Get-CMCollection
SYNOPSIS
Obtém uma coleção de Gestor de Configuração.
SYNTAX
ByName (Padrão)
Get-CMCollection [-CollectionType <CollectionType>] [-Name <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
Grupo ByDP
Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroup <IResultObject>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByDPGroupId
Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupId <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByDPGroupName
Get-CMCollection [-CollectionType <CollectionType>] -DistributionPointGroupName <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ById
Get-CMCollection [-CollectionType <CollectionType>] -Id <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
O cmdlet Get-CMCollection obtém uma coleção de Gestor de Configuração.
As coleções de Gestor de Configuração fornecem uma forma de gerir utilizadores, computadores e outros recursos na sua organização. Não só lhe dão um meio de organizar os seus recursos, como também lhe dão um meio de distribuir pacotes de Gestor de Configuração a clientes e utilizadores.
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 uma coleção pelo nome
PS XYZ:\> Get-CMCollection -Name "testUser"
Este comando recebe a coleção chamada TestUser.
Exemplo 2: Obter uma coleção para um grupo de pontos de distribuição
PS XYZ:\> Get-CMDistributionPointGroup -Name "testDPGroup" | Get-CMCollection
Este comando obtém o objeto do grupo ponto de distribuição denominado testDPGroup e utiliza o operador do gasoduto para passar o objeto para Get-CMCollection, que recebe a coleção associada ao grupo ponto de distribuição.
PARAMETERS
-CollectionType
Especifica um tipo para a coleção. Os valores válidos são:
- Raiz
- Utilizador
- Dispositivo
- Desconhecido
Type: CollectionType
Parameter Sets: (All)
Aliases:
Accepted values: User, Device
Required: False
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
-DistributionPointGroup
Especifica um objeto de grupo ponto de distribuição que está associado a uma coleção. Para obter um objeto de grupo ponto de distribuição, utilize o cmdlet Get-CMDistributionPointGroup.
Type: IResultObject
Parameter Sets: ByDPGroup
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-DistributionPointGroupId
Especifica o ID do grupo de pontos de distribuição que está associado à coleção.
Type: String
Parameter Sets: ByDPGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Especifica o nome do grupo de pontos de distribuição que está associado a uma coleção.
Type: String
Parameter Sets: ByDPGroupName
Aliases:
Required: True
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
- ID
Especifica uma identificação de coleção. Se não especificar uma coleção, todas as coleções da hierarquia são devolvidas.
Type: String
Parameter Sets: ById
Aliases: CollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica um nome de coleção. Se não especificar uma coleção, todas as coleções da hierarquia são devolvidas.
Type: String
Parameter Sets: ByName
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.