Set-CMCollection

  • Referência
Módulo:
ConfigurationManager

Configure um dispositivo ou uma coleção de usuários.

Syntax

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar um dispositivo ou uma coleção de usuários.

A coleção de limitação determina quais recursos podem ser membros da coleção. Por exemplo, quando você usa a coleção All Systems como a coleção limiting, a nova coleção pode incluir qualquer dispositivo na hierarquia Configuration Manager.

Adicione recursos à coleção com regras de associação. Para adicionar membros à coleção, use um dos cmdlets para adicionar regras de associação, por exemplo:

Você não pode configurar coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS.

Para obter mais informações, consulte Como criar coleções no 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: renomear uma coleção

O primeiro comando obtém o objeto de coleção chamado testUser e o armazena na variável $userCollection .

O segundo comando atualiza o nome da coleção.

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

Parâmetros

-CollectionId

Especifique a ID da coleção a ser configurada. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Você não pode configurar coleções padrão, portanto, esse valor começa com o código do site, não SMScom .

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

-Comment

Especifique um comentário opcional para descrever e identificar essa coleção.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-InputObject

Especifique um objeto de coleção a ser configurado. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LimitingCollection

Especifique um objeto para a coleção de limitação. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

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

-LimitingCollectionId

Especifique a ID da coleção de limitação. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012 ou SMS00001.

Type:String
Aliases:LimitToCollectionId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LimitingCollectionName

Especifique o nome da coleção de limitação.

Type:String
Aliases:LimitToCollectionName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome de uma coleção a ser configurada.

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

-NewName

Especifique um novo nome para a coleção. Use esse parâmetro para renomeá-lo.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-RefreshSchedule

Se você definir o parâmetro RefreshType como Periodic ou Both, use esse parâmetro para definir o agendamento. Especifique um objeto de agenda para quando o site executar uma atualização completa da associação de coleção. Para obter esse objeto, use o cmdlet New-CMSchedule .

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

-RefreshType

Especifique como a associação de coleção é atualizada:

  • Manual(1): Um administrador dispara manualmente uma atualização de associação no console Configuration Manager ou com o cmdlet Invoke-CMCollectionUpdate.
  • Periodic (2): O site faz uma atualização completa em uma agenda. Ele não usa atualizações incrementais. Se você não especificar um tipo, esse valor será o padrão.
  • Continuous (4): O site avalia periodicamente novos recursos e adiciona novos membros. Esse tipo também é conhecido como uma atualização incremental. Ele não faz uma atualização completa em uma agenda.
  • Both (6): uma combinação de ambos Periodic e Continuous, com atualizações incrementais e uma atualização completa em uma agenda.

Se você especificar ou PeriodicBoth, use o parâmetro RefreshSchedule para definir o agendamento.

Observação

O None valor (0) é funcionalmente o mesmo que Manual.

Type:CollectionRefreshType
Accepted values:None, Manual, Periodic, Continuous, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariablePriority

Especifique um valor inteiro de 1 a 9 para a prioridade das variáveis de coleção de dispositivos. 1 é a prioridade mais baixa e 9 é a mais alta.

Para configurar variáveis em uma coleção de dispositivos, use o cmdlet Set-CMDeviceCollectionVariable .

Para exibir a prioridade da variável atual, use o cmdlet Get-CMCollectionSetting .

Type:Int32
Aliases:DeviceCollectionVariablePrecedence
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object