Update-SCSMConnector
Atualiza as propriedades de um conector do Service Manager.
Sintaxe
Update-SCSMConnector
[-Connector] <Connector[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Update-SCSMConnector atualiza as propriedades de um conector do Service Manager. Por exemplo, você pode definir a propriedade Enable como $False desabilitar o conector ou pode defini-la como $True para habilitar o conector. Use este cmdlet em conjunto com o cmdlet Get-SCSMConnector. Depois que Get-SCSmConnector recuperar o objeto, você poderá modificar as propriedades do objeto e passá-lo para o cmdlet atual. Este cmdlet atualiza as propriedades.
A agenda propriedade só estará disponível se você tiver aplicado o Service Manager 2012 R2 Update Rollup 6 ou posterior.
Para cada tipo de conector, você pode atualizar as seguintes propriedades:
Conector do Ative Directory
- Descrição
- Ativar
- Designação
- RunAsAccount
- SelectedObjects
- Horário
Conector do Configuration Manager
- Coleções
- Descrição
- Ativar
- Designação
- RunAsAccount
- Horário
Conector de alerta do Operations Manager
- FecharAlerta
- Descrição
- Ativar
- Designação
- ResolveIncident
- Regras
- RunAsAccount
- Horário
- Modelo
Conector CI do Operations Manager
- Descrição
- Ativar
- Designação
- OperationsManagerServer
- RunAsAccount
- Horário
Exemplos
Exemplo 1: Atualizar objetos em um conector do Ative Directory
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> $ADConnector = Get-SCSMConnector -Name "WOODGROVE Active Directory"
PS C:\> $ADConnector.Select = "(&(objectCategory=computer)(name=*fulle*))"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector
Este exemplo atualiza os objetos selecionados de um conector do Ative Directory. O primeiro comando obtém uma conta Run As, usando o cmdlet Get-SCSMRunAsAccount e, em seguida, armazena-a na variável $RunAsAccount.
O segundo comando obtém um conector usando o cmdlet Get-SCSMConnector e o armazena na variável $ADConnector.
O terceiro comando atribui um valor à propriedade Select de $ADConnector.
O comando final obtém todos os conectores e, em seguida, passa aqueles que usam o $RunAsAccount como a conta Run As para o cmdlet atual. Esse cmdlet atualiza os conectores.
Exemplo 2: Atualizar a conta Run As para conectores
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector
O primeiro comando obtém a conta Run As que tem o nome de perfil NewProfile e, em seguida, armazena o resultado na variável $RunAsAccount.
O segundo comando atualiza todos os conectores que têm a conta Run As do $RunAsAccount.
Exemplo 3: Atualizar um conector de alerta do Operations Manager
PS C:\>$AlertConnector = Get-SCSMConnector "Alert Connector"
PS C:\>$AlertConnector.rules += New-SCSMAlertRule @{
>> Name = "newRule"
>> Template = Get-SCSMObjectTemplate -Name ".*IncidentTemplate.*"
>> ManagementPack = Get-SCManagementPack "System.Library"
>>}
PS C:\>Update-SCSMConnector -Connector $AlertConnector
Este exemplo adiciona uma nova regra a um conector de Alerta do Operations Manager. O primeiro comando obtém um conector e, em seguida, armazena-o na variável $AlertConnector.
O segundo comando adiciona uma regra às regras propriedade de $AlertConnector. O cmdlet New-SCSMAlertRule cria a regra. O comando se estende por várias linhas.
O comando final atualiza o conector para o valor atual de $AlertConnector.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Connector
Especifica um objeto que representa um conector do Service Manager.
Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[] |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PassThru
Indica que esse cmdlet retorna o conector que ele atualiza. Você pode passar esse objeto para outros cmdlets.
Tipo: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector
Você pode canalizar um conector para o Connector parâmetro.
Saídas
None.
Este cmdlet não gera nenhuma saída.