New-SCADConnector
Crée un connecteur Active Directory Service Manager.
Syntaxe
New-SCADConnector
[[-Description] <String>]
[-Enable <Boolean>]
[-DisplayName] <String>
[[-QueryRoot] <String>]
[-PassThru]
[-ComputerFilter <String>]
[-UserFilter <String>]
[-PrinterFilter <String>]
-ADCredential <PSCredential>
[[-RunAsAccount] <ManagementPackSecureReference>]
[-ScheduleDay <DaySchedule>]
[-ScheduleHour <Int32>]
[-SyncNow]
[-ExpandGroups]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
L’applet de commande New-SCADConnector crée un connecteur Active Directory Service Manager.
Les paramètres suivants sont disponibles uniquement si vous avez appliqué Service Manager 2012 R2 Update Rollup 6 ou versions ultérieures.
- ScheduleDay
- scheduleHour
Exemples
Exemple 1 : Créer un connecteur au domaine local
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso AD Connector" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -ScheduleDay Sunday -ScheduleHour 3La première commande obtient un compte d’identification pour le compte de flux de travail à l’aide de l’applet de commande Get-SCSMRunAsAccount. La commande stocke le résultat dans la variable $RunAsAccount.
La deuxième commande vous invite à entrer des informations d’identification à l’aide de l’applet de commande Get-Credential, puis stocke les informations d’identification dans la variable $Credential.
La commande finale crée un connecteur Active Directory au domaine local, qui récupère tous les ordinateurs, imprimantes, utilisateurs et groupes d’utilisateurs. Le connecteur est configuré pour synchroniser tous les dimanches à 3 h 00.
Exemple 2 : Créer un connecteur au domaine local qui inclut un filtre utilisateur
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso users starting with E" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -UserFilter "(givenname=E*)"La première commande obtient un compte d’identification pour le compte de flux de travail, puis la stocke dans la variable $RunAsAccount.
La deuxième commande vous invite à entrer des informations d’identification à l’aide de l’applet de commande Get-Credential, puis stocke les informations d’identification dans la variable $Credential.
La commande finale crée un connecteur Active Directory au domaine local qui récupère uniquement les comptes d’utilisateur qui commencent par la lettre E.
Paramètres
-ADCredential
Spécifie les informations d’identification à utiliser lorsque cette applet de commande se connecte au contrôleur de domaine.
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerFilter
Spécifie un filtre qui sélectionne les ordinateurs synchronisés par le connecteur.
Le filtre doit être spécifié en tant que filtre Active Directory.
Par exemple, le filtre suivant inclut tous les ordinateurs qui commencent par win dans la synchronisation :
(name=win*)
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerName
Spécifie le nom de l’ordinateur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié dans le paramètre Credential doit avoir des droits d’accès à l’ordinateur spécifié.
| Type: | System.String[] |
| Position: | Named |
| Valeur par défaut: | Localhost |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-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 |
-Credential
Spécifie les informations d’identification que cette applet de commande utilise pour se connecter au serveur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié doit avoir des droits d’accès à ce serveur.
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Spécifie une description du connecteur.
| Type: | System.String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisplayName
Spécifie la propriété du nom complet du connecteur.
| Type: | System.String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Enable
Indique si cette applet de commande active ou désactive le connecteur.
| Type: | System.Boolean |
| Position: | Named |
| Valeur par défaut: | True |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExpandGroups
Spécifie que cette applet de commande inclut de manière récursive les membres des groupes spécifiés par le paramètre UserFilter.
| 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 |
-PassThru
Indique que cette applet de commande retourne le connecteur Active Directory qu’il crée. Vous pouvez transmettre 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 |
-PrinterFilter
Spécifie un filtre que cette applet de commande utilise pour sélectionner les imprimantes synchronisées par le connecteur.
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-QueryRoot
Spécifie le dossier Active Directory à partir duquel cette applet de commande interroge des objets, tels que LDAP ://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
| Type: | System.String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsAccount
Spécifie le compte d’identification à utiliser lors de l’utilisation de ce connecteur.
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
| Position: | 3 |
| Valeur par défaut: | Operational System Account |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ScheduleDay
Spécifie le jour de la semaine sur lequel le connecteur se synchronise. Les valeurs valides sont les suivantes :
- Quotidien
- Dimanche
- Lundi
- Mardi
- Mercredi
- Jeudi
- Vendredi
- Samedi
| Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
| Valeurs acceptées: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Valeur par défaut: | Daily |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ScheduleHour
Spécifie l’heure à laquelle le connecteur démarre la synchronisation. La valeur doit être un nombre compris entre zéro (0) et 23.
| Type: | System.Int32 |
| Position: | Named |
| Valeur par défaut: | 2 |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SCSession
Spécifie un objet qui représente la session sur un serveur d’administration Service Manager.
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SyncNow
Provoque le démarrage d’un cycle de synchronisation par le connecteur Active Directory.
| 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 |
-UserFilter
Spécifie le filtre utilisé pour sélectionner les utilisateurs à l’état synchronisé par le connecteur.
Vous devez spécifier la valeur sous la forme d’un filtre Active Directory.
Par exemple, la valeur suivante pour ce paramètre inclut dans les utilisateurs de synchronisation dont givenName commence par a:
(givenname=a*)
| Type: | System.String |
| 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 n’est pas exécutée.
| 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
None.
Vous ne pouvez pas diriger l’entrée vers cette applet de commande.
Sorties
None.
Cette applet de commande ne génère aucune sortie.