Update-SCSMConnector
Actualiza las propiedades de un conector de Service Manager.
Sintaxis
Update-SCSMConnector
[-Connector] <Connector[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Update-SCSMConnector actualiza las propiedades de un conector de Service Manager. Por ejemplo, puede establecer la propiedad Enable en $False para deshabilitar el conector, o bien puede establecerla en $True para habilitar el conector. Use este cmdlet junto con el cmdlet Get-SCSMConnector. Después de Get-SCSmConnector recupera el objeto, puede modificar las propiedades del objeto y, a continuación, pasarlo al cmdlet actual. Este cmdlet actualiza las propiedades.
La programación propiedad solo está disponible si ha aplicado service Manager 2012 R2 Update Rollup 6 o posterior.
Para cada tipo de conector, puede actualizar las siguientes propiedades:
Conector de Active Directory
- Descripción
- Habilitar
- Nombre
- RunAsAccount
- SelectedObjects
- Horario
Conector de Configuration Manager
- Colecciones
- Descripción
- Habilitar
- Nombre
- RunAsAccount
- Horario
Conector de alertas de Operations Manager
- CloseAlert
- Descripción
- Habilitar
- Nombre
- ResolveIncident
- Reglas
- RunAsAccount
- Horario
- Plantilla
Conector de CI de Operations Manager
- Descripción
- Habilitar
- Nombre
- OperationsManagerServer
- RunAsAccount
- Horario
Ejemplos
Ejemplo 1: Actualización de objetos en un conector de Active 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
En este ejemplo se actualizan los objetos seleccionados de un conector de Active Directory. El primer comando obtiene una cuenta de ejecución, mediante el cmdlet Get-SCSMRunAsAccount y, a continuación, la almacena en la variable $RunAsAccount.
El segundo comando obtiene un conector mediante el cmdlet Get-SCSMConnector y, a continuación, lo almacena en la variable $ADConnector.
El tercer comando asigna un valor a la propiedad Select de $ADConnector.
El comando final obtiene todos los conectores y, a continuación, pasa los que usan el $RunAsAccount como cuenta de ejecución al cmdlet actual. Ese cmdlet actualiza los conectores.
Ejemplo 2: Actualización de la cuenta de ejecución para conectores
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector
El primer comando obtiene la cuenta de ejecución que tiene el nombre de perfil NewProfile y, a continuación, almacena el resultado en la variable $RunAsAccount.
El segundo comando actualiza todos los conectores que tienen la cuenta de ejecución de $RunAsAccount.
Ejemplo 3: Actualización de un conector de alertas de 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
En este ejemplo se agrega una nueva regla a un conector de alertas de Operations Manager. El primer comando obtiene un conector y, a continuación, lo almacena en la variable $AlertConnector.
El segundo comando agrega una regla a las reglas de propiedad de $AlertConnector. El cmdlet New-SCSMAlertRule crea la regla. El comando se extiende en varias líneas.
El comando final actualiza el conector al valor actual de $AlertConnector.
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Connector
Especifica un objeto que representa un conector de Service Manager.
Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[] |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-PassThru
Indica que este cmdlet devuelve el conector que actualiza. Puede pasar este objeto a otros cmdlets.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector
Puede canalizar un conector al parámetro
Salidas
None.
Este cmdlet no genera ninguna salida.