Partager via


Update-SCSMConnector

Met à jour les propriétés d’un connecteur Service Manager.

Syntaxe

Update-SCSMConnector
      [-Connector] <Connector[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Update-SCSMConnector met à jour les propriétés d’un connecteur Service Manager. Par exemple, vous pouvez définir la propriété Enable sur $False pour désactiver le connecteur, ou vous pouvez la définir sur $True pour activer le connecteur. Utilisez cette applet de commande conjointement avec l’applet de commande Get-SCSMConnector. Une fois que Get-SCSmConnector a récupéré l’objet, vous pouvez modifier les propriétés de l’objet, puis le transmettre à l’applet de commande actuelle. Cette applet de commande met à jour les propriétés.

La propriété schedule n’est disponible que si vous avez appliqué Service Manager 2012 R2 Update Rollup 6 ou version ultérieure.

Pour chaque type de connecteur, vous pouvez mettre à jour les propriétés suivantes :

Connecteur Active Directory

  • Descriptif
  • Activer
  • Nom
  • RunAsAccount
  • SelectedObjects
  • Calendrier

Connecteur Configuration Manager

  • Collections
  • Descriptif
  • Activer
  • Nom
  • RunAsAccount
  • Calendrier

Connecteur d’alerte Operations Manager

  • FermerAlerte
  • Descriptif
  • Activer
  • Nom
  • RésoudreIncident
  • Règles
  • RunAsAccount
  • Calendrier
  • Modèle

Connecteur CI Operations Manager

  • Descriptif
  • Activer
  • Nom
  • OperationsManagerServeur
  • RunAsAccount
  • Calendrier

Exemples

Exemple 1 : Mettre à jour des objets dans un connecteur 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

Cet exemple met à jour les objets sélectionnés d’un connecteur Active Directory. La première commande obtient un compte d’identification, à l’aide de l’applet de commande Get-SCSMRunAsAccount, puis le stocke dans la variable $RunAsAccount.

La deuxième commande obtient un connecteur à l’aide de l’applet de commande Get-SCSMConnector , puis le stocke dans la variable $ADConnector.

La troisième commande attribue une valeur à la propriété Select de $ADConnector.

La commande finale récupère tous les connecteurs, puis transmet ceux qui utilisent le $RunAsAccount en tant que compte d’identification à l’applet de commande actuelle. Cette applet de commande met à jour les connecteurs.

Exemple 2 : Mettre à jour le compte d’identification pour les connecteurs

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector

La première commande récupère le compte d’identification portant le nom de profil NewProfile, puis stocke le résultat dans la variable $RunAsAccount.

La deuxième commande met à jour tous les connecteurs qui ont le compte d’identification de $RunAsAccount.

Exemple 3 : Mettre à jour un connecteur d’alerte 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

Cet exemple ajoute une nouvelle règle à un connecteur d’alerte Operations Manager. La première commande récupère un connecteur, puis le stocke dans la variable $AlertConnector.

La deuxième commande ajoute une règle à la propriété rules de $AlertConnector. L’applet de commande New-SCSMAlertRule crée la règle. La commande s’étend sur plusieurs lignes.

La commande finale met à jour le connecteur à la valeur actuelle de $AlertConnector.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Connector

Spécifie un objet qui représente un connecteur Service Manager.

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Indique que cette applet de commande retourne le connecteur qu’elle met à jour. Vous pouvez passer cet objet à d’autres applets de commande.

Type:System.Management.Automation.SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Type:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector

Vous pouvez rediriger un connecteur vers le paramètre Connector .

Sorties

None.

Cette applet de commande ne génère aucune sortie.