New-CMDeviceCollection
SYNOPSIS
Cria uma coleção para dispositivos e adiciona a coleção à hierarquia do Gestor de Configuração.
SYNTAX
ByName (Padrão)
New-CMDeviceCollection [-Comment <String>] -LimitingCollectionName <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMDeviceCollection [-Comment <String>] -InputObject <IResultObject> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMDeviceCollection [-Comment <String>] -LimitingCollectionId <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
O cmdlet New-CMDeviceCollection cria uma coleção baseada numa coleção específica de limitação. A recolha limitativa determina quais os dispositivos que podem ser membros da coleção de dispositivos que cria. Por exemplo, quando utiliza a coleção All Systems como a coleção limitante, a nova coleção pode incluir qualquer dispositivo na hierarquia do Gestor de Configuração. Especifica a coleção limitativa fornecendo o seu nome ou ID.
Os dispositivos são adicionados à coleção pelas regras de adesão. Para adicionar membros à recolha do dispositivo, utilize uma das seguintes regras de adesão:
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMDeviceCollectionExcludeMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
As coleções representam agrupamentos lógicos de recursos, como utilizadores e dispositivos. Para obter mais informações sobre as coleções do Gestor de Configuração, consulte Introdução às Coleções no Gestor de Configuração.
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: Criar uma coleção de dispositivos
PS XYZ:\> New-CMDeviceCollection -Name "Windows 7" -LimitingCollectionName "All Systems"
Este comando cria uma coleção para todos os computadores que funcionam Windows 7. O parâmetro LimitingCollectionName especifica que qualquer dispositivo na coleção All Systems pode ser membro da coleção Windows 7.
PARAMETERS
-Comentário
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica a entrada para este cmdlet. Pode utilizar este parâmetro ou canalizar a entrada para este cmdlet.
Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollectionId
Type: String
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Limitação Do Nome deCollection
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Type: CollectionRefreshType
Parameter Sets: (All)
Aliases:
Accepted values: None, Manual, Periodic, Continuous, Both
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
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.