Set-CMDiscoveryMethod

  • Referência
Módulo:
ConfigurationManager

Altera as definições de configuração de um método de deteção.

Sintaxe

Set-CMDiscoveryMethod
   [-ActiveDirectoryForestDiscovery]
   [-EnableActiveDirectorySiteBoundaryCreation <Boolean>]
   [-Enabled <Boolean>]
   [-EnableSubnetBoundaryCreation <Boolean>]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryContainer <String[]>]
   [-ActiveDirectorySystemDiscovery]
   [-AddActiveDirectoryContainer <String[]>]
   [-AddAdditionalAttribute <String[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableFilteringExpiredLogon <Boolean>]
   [-EnableFilteringExpiredPassword <Boolean>]
   [-EnableIncludeGroup <Boolean>]
   [-EnableRecursive <Boolean>]
   [-IncludeGroup]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-Recursive]
   [-RemoveActiveDirectoryContainer <String[]>]
   [-RemoveAdditionalAttribute <String[]>]
   [-SiteCode <String>]
   [-TimeSinceLastLogonDays <Int32>]
   [-TimeSinceLastPasswordUpdateDays <Int32>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryContainer <String[]>]
   [-ActiveDirectoryUserDiscovery]
   [-AddActiveDirectoryContainer <String[]>]
   [-AddAdditionalAttribute <String[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableIncludeGroup <Boolean>]
   [-EnableRecursive <Boolean>]
   [-IncludeGroup]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-Recursive]
   [-RemoveActiveDirectoryContainer <String[]>]
   [-RemoveAdditionalAttribute <String[]>]
   [-SiteCode <String>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryGroupDiscovery]
   [-AddGroupDiscoveryScope <ADGroupDiscoveryScope[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-DiscoverDistributionGroupMembership <Boolean>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableFilteringExpiredLogon <Boolean>]
   [-EnableFilteringExpiredPassword <Boolean>]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-RemoveGroupDiscoveryScope <String[]>]
   [-SiteCode <String>]
   [-TimeSinceLastLogonDays <Int32>]
   [-TimeSinceLastPasswordUpdateDays <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-NetworkDiscovery]
   [-NetworkDiscoveryType <NetworkDiscoveryType>]
   [-PassThru]
   [-SiteCode <String>]
   [-SlowNetworkSpeed <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-Heartbeat]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMDiscoveryMethod altera as definições de configuração de um método de deteção. A deteção identifica os recursos do computador e do utilizador que o Configuration Manager pode gerir. Quando o Configuration Manager deteta um recurso, o Configuration Manager cria um registo na base de dados do Configuration Manager para o recurso e as respetivas informações associadas. Em seguida, pode utilizar as informações de deteção para o ajudar a instalar o cliente do Configuration Manager e criar consultas e coleções personalizadas para agrupar logicamente recursos para tarefas de gestão relacionadas.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Modificar a deteção de rede

PS XYZ:\> Set-CMDiscoveryMethod -NetworkDiscovery -SiteCode "CM4" -Enabled $True -NetworkDiscoveryType ToplogyAndClient -SlowNetworkSpeed $True

Este comando modifica a deteção de rede para o site que tem o código do site CM4. O comando especifica a topologia e a deteção de rede do cliente e a opção de velocidade de rede lenta. O comando também ativa a deteção.

Exemplo 2: Modificar a deteção do sistema do Active Directory

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectorySystemDiscovery -SiteCode "CM4" -AddAdditionalAttribute "331", "431", "134" -DeltaDiscoveryIntervalMinutes 8 -Enabled $True -EnableDeltaDiscovery $True -EnableFilteringExpiredLogon $True -PollingSchedule $Schedule -RemoveAdditionalAttribute "123","cn" -TimeSinceLastLogonDays 80

O primeiro comando cria um objeto de agendamento com o cmdlet New-CMSchedule e armazena-o na variável $Schedule.

O segundo comando ativa a deteção de computadores para o site que tem o código do site CM4. O comando especifica o objeto de agendamento armazenado na variável $Schedule como agenda de consulta e permite que a deteção delta encontre computadores novos e modificados desde a última deteção. O comando especifica que a deteção delta ocorre a cada 8 minutos.

O segundo comando também limita os computadores que um utilizador iniciou sessão nos últimos 80 dias. Além disso, o comando adiciona e remove atributos especificados dos atributos utilizados para limitar os computadores.

Exemplo 3: Modificar a deteção de floresta

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectoryForestDiscovery -SiteCode "CM4" -EnableActiveDirectorySiteBoundaryCreation $True -Enabled $True  -EnableSubnetBoundaryCreation $True -PollingSchedule $Schedule

O primeiro comando cria um objeto de agendamento com o cmdlet New-CMSchedule e, em seguida, armazena-o na variável $Schedule.

O segundo comando ativa este site de deteção que tem o código do site CM4. O comando especifica o objeto de agendamento armazenado na variável $Schedule como o intervalo de consulta e permite a criação de limites do Active Directory e a criação de limites de sub-rede.

Exemplo 4: Ativar a deteção de heartbeat

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -Heartbeat -SiteCode "CM4" -Enabled $True -PollingSchedule $Schedule

O primeiro comando cria um objeto de agendamento com o cmdlet New-CMSchedule e armazena-o na variável $Schedule.

O segundo comando ativa a deteção de heartbeat e especifica o objeto armazenado na variável $Schedule como a agenda de consultas para o site que tem o código do site CM4.

Parâmetros

-ActiveDirectoryContainer

Especifica uma matriz de nomes de contentores do Active Directory.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ActiveDirectoryForestDiscovery

Indica que o método de deteção deteta grupos de segurança, incluindo grupos locais, globais e universais a partir de localizações especificadas nos Serviços de Domínio do Active Directory (AD DS).

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ActiveDirectoryGroupDiscovery

Indica que o método de deteção deteta informações adicionais, incluindo a unidade organizacional (UO) do computador e a associação a grupos, sobre computadores detetados anteriormente a partir de localizações especificadas no AD DS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ActiveDirectorySystemDiscovery

Indica que o método de deteção deteta computadores a partir de localizações especificadas no AD DS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ActiveDirectoryUserDiscovery

Indica que o método de deteção deteta utilizadores de localizações especificadas no AD DS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddActiveDirectoryContainer

Tipo:String[]
Aliases:AddActiveDirectoryContainers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddAdditionalAttribute

Especifica uma matriz de atributos de objetos do Active Directory. O cmdlet adiciona estes atributos à lista de atributos que o Configuration Manager deteta.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddGroupDiscoveryScope

Tipo:ADGroupDiscoveryScope[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearActiveDirectoryContainer

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeltaDiscoveryMins

Tipo:Int32
Aliases:DeltaDiscoveryIntervalMinutes, DeltaDiscoveryIntervalMins
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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

-DiscoverDistributionGroupMembership

Tipo:Boolean
Aliases:DiscoverDistributionGroupsMembership
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableActiveDirectorySiteBoundaryCreation

Indica se o Configuration Manager cria limites do Active Directory a partir de informações de deteção do AD DS.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Enabled

Indica se pretende ativar a deteção do Configuration Manager. Se especificar um valor de $False, o Configuration Manager não deteta recursos com esta deteção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableDeltaDiscovery

Indica se o Configuration Manager deteta os recursos criados ou modificados no AD DS desde o último ciclo de deteção. Se especificar um valor de $True para este parâmetro, especifique um valor para o parâmetro DeltaDiscoveryIntervalMinutes .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableFilteringExpiredLogon

Indica se o Configuration Manager deteta apenas computadores com sessão iniciada num domínio num número especificado de dias. Especifique o número de dias com o parâmetro TimeSinceLastLogonDays .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableFilteringExpiredPassword

Indica se o Configuration Manager deteta apenas os computadores que atualizaram a palavra-passe da conta de computador num número especificado de dias. Especifique o número de dias com o parâmetro TimeSinceLastPasswordUpdateDays .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableIncludeGroup

{{ Fill EnableIncludeGroup Description }}

Tipo:Boolean
Aliases:EnableIncludeGroups
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableRecursive

{{ Fill EnableRecursive Description }}

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableSubnetBoundaryCreation

Indica se o Configuration Manager cria limites de intervalo de endereços IP a partir das informações de deteção do AD DS.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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

-Heartbeat

Indica que o método de deteção atualiza os registos de deteção para clientes do Configuration Manager na base de dados do Configuration Manager sem detetar novos recursos.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IncludeGroup

Tipo:SwitchParameter
Aliases:IncludeGroups
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkDiscovery

Indica que o método de deteção procura na infraestrutura de rede dispositivos de rede, como impressoras, routers e pontes, que tenham endereços IP.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkDiscoveryType

Especifica o tipo de deteção de rede. Se especificar o parâmetro NetworkDiscovery , especifique um dos seguintes tipos:

  • ToplogyAndClient. A deteção localiza a topologia da sua rede e potenciais dispositivos cliente.
  • ToplogyClientAndClientOperatingSystem. A deteção localiza a topologia da sua rede. A deteção localiza potenciais dispositivos cliente e os respetivos sistemas operativos e versões.
  • Topologia. A deteção localiza a topologia da sua rede ao detetar sub-redes IP e routers.
Tipo:NetworkDiscoveryType
Valores aceitos:Topology, TopologyAndClient, ToplogyAndClient, TopologyClientAndClientOperatingSystem, ToplogyClientAndClientOperatingSystem
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PollingSchedule

Especifica um objeto de agendamento. Para obter um objeto de agendamento, utilize o cmdlet New-CMSchedule . A agenda de consultas determina a frequência com que o Configuration Manager tenta detetar grupos, sistemas ou dados de utilizador.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Recursive

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveActiveDirectoryContainer

Tipo:String[]
Aliases:RemoveActiveDirectoryContainers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveAdditionalAttribute

Especifica uma matriz de atributos de objetos do Active Directory. O cmdlet remove estes atributos da lista de atributos que o Configuration Manager deteta.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveGroupDiscoveryScope

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

Especifica o código do site para um site do Configuration Manager.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SlowNetworkSpeed

Indica se o Configuration Manager efetua ajustes às definições de deteção para redes com pouca largura de banda.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeSinceLastLogonDays

Especifica o número de dias desde o último início de sessão quando o parâmetro EnableFilteringExpiredLogon tinha um valor de $True.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeSinceLastPasswordUpdateDays

Especifica o número de dias desde a última palavra-passe atualizada quando o parâmetro EnableFilteringExpiredPassword tinha um valor de $True.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserName

{{ Descrição do Nome de Utilizador de Preenchimento }}

Tipo:String
Aliases:DiscoveryAccountUserName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None