Invoke-CMCollectionUpdate

  • Referência
Módulo:
ConfigurationManager

Atualize a associação de uma coleção.

Syntax

Invoke-CMCollectionUpdate
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -CollectionId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para atualizar a associação de uma coleção. O site avalia a associação para a coleção selecionada com base nas regras de associação da coleção. Para coleções com muitos membros, essa atualização pode levar algum tempo para ser concluída.

Para obter mais informações, consulte Avaliação de coleção 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: atualizar a associação de uma coleção usando o pipeline

Esse comando obtém o objeto de coleção com a ID de XYZ00014 e usa o operador de pipeline para passar o objeto para Invoke-CMCollectionUpdate, que atualiza a associação da coleção.

Get-CMCollection -Id XYZ00014 | Invoke-CMCollectionUpdate

Exemplo 2: atualizar a associação de uma coleção pelo nome

Este comando atualiza a associação da coleção chamada UserCol1.

Invoke-CMCollectionUpdate -Name "UserCol1"

Parâmetros

-CollectionId

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

Type:String
Position:Named
Default value:None
Required:True
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 atualizado. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

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

-Name

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

Type:String
Position:Named
Default value:None
Required:True
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