Update-SCSMConnector
Met à jour les propriétés d'un connecteur Service Manager.
Syntax
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 le définir sur $True pour activer le connecteur. Utilisez cette applet de commande conjointement avec l’applet de commande Get-SCSMConnector. Une fois Get-SCSmConnector 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é de planification n’est disponible que si vous avez appliqué Service Manager correctif cumulatif R2 R2 6 ou version ultérieure.
Pour chaque type de connecteur, vous pouvez mettre à jour les propriétés suivantes :
Connecteur Active Directory
- Description
- Activer
- Nom
- RunAsAccount
- SelectedObjects
- Planifier
Connecteur Configuration Manager
- Collections
- Description
- Activer
- Nom
- RunAsAccount
- Planifier
Connecteur d'alerte Operations Manager
- CloseAlert
- Description
- Activer
- Nom
- ResolveIncident
- Règles
- RunAsAccount
- Planifier
- Modèle
Connecteur CI Operations Manager
- Description
- Activer
- Nom
- OperationsManagerServer
- RunAsAccount
- Planifier
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 la stocke dans la variable $RunAsAccount.
La deuxième commande obtient un connecteur à l’aide de l’applet de commande Get-SCSMConnector , puis la stocke dans la variable $ADConnector.
La troisième commande affecte une valeur à la propriété Select de $ADConnector.
La commande finale obtient tous les connecteurs, puis transmet ceux qui utilisent le $RunAsAccount comme compte d’identification à l’applet de commande active. 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 obtient le compte d’identification qui a 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 montre comment ajouter une nouvelle règle à un connecteur d’alerte Operations Manager. La première commande obtient un connecteur, puis la stocke dans la variable $AlertConnector.
La deuxième commande ajoute une règle à la propriété de règles 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 demande une confirmation avant d’exécuter l’applet de commande.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Connector
Spécifie un objet représentant un connecteur Service Manager.
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Indique que cette applet de commande retourne le connecteur qu’il met à jour. Vous pouvez transmettre cet objet à d’autres applets de commande.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector
Vous pouvez diriger un connecteur vers le paramètre Connecteur .
Sorties
None.
Cette applet de commande ne génère aucune sortie.