New-SCADConnector
Crea un nuevo conector de Active Directory de Service Manager.
Sintaxis
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
El cmdlet New-SCADConnector crea un conector de Active Directory de Service Manager.
Los parámetros siguientes solo están disponibles si ha aplicado service Manager 2012 R2 Update Rollup 6 o versiones posteriores.
- scheduleDay
- scheduleHour
Ejemplos
Ejemplo 1: Creación de un conector en el dominio 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 3
El primer comando obtiene una cuenta de ejecución para la cuenta de flujo de trabajo mediante el cmdlet Get-SCSMRunAsAccount. El comando almacena el resultado en la variable $RunAsAccount.
El segundo comando le pide credenciales mediante el cmdlet Get-Credential y, a continuación, almacena las credenciales en la variable $Credential.
El comando final crea un conector de Active Directory en el dominio local, que recupera todos los equipos, impresoras, usuarios y grupos de usuarios. El conector está configurado para sincronizarse todos los domingos a las 3:00 a.m.
Ejemplo 2: Creación de un conector en el dominio local que incluye un filtro de usuario
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*)"
El primer comando obtiene una cuenta de ejecución para la cuenta de flujo de trabajo y, a continuación, la almacena en la variable $RunAsAccount.
El segundo comando le pide credenciales mediante el cmdlet Get-Credential y, a continuación, almacena las credenciales en la variable $Credential.
El comando final crea un conector de Active Directory en el dominio local que recupera solo las cuentas de usuario que comienzan por la letra E.
Parámetros
-ADCredential
Especifica la credencial que se va a usar cuando este cmdlet se conecta al controlador de dominio.
Tipo: | System.Management.Automation.PSCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ComputerFilter
Especifica un filtro que selecciona los equipos que sincroniza el conector.
El filtro debe especificarse como filtro de Active Directory.
Por ejemplo, el siguiente filtro incluye todos los equipos que comienzan por win
en la sincronización:
(name=win*)
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ComputerName
Especifica el nombre del equipo en el que se ejecuta el servicio de acceso a datos de System Center.
La cuenta de usuario especificada en el parámetro credential
Tipo: | System.String[] |
Posición: | Named |
Valor predeterminado: | Localhost |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-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 |
-Credential
Especifica las credenciales que usa este cmdlet para conectarse al servidor en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada debe tener derechos de acceso a ese servidor.
Tipo: | System.Management.Automation.PSCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Description
Especifica una descripción para el conector.
Tipo: | System.String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisplayName
Especifica la propiedad de nombre para mostrar del conector.
Tipo: | System.String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Enable
Indica si este cmdlet habilita o deshabilita el conector.
Tipo: | System.Boolean |
Posición: | Named |
Valor predeterminado: | True |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ExpandGroups
Especifica que este cmdlet incluye de forma recursiva los miembros de los grupos especificados por el parámetro UserFilter.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Indica que este cmdlet devuelve el conector de Active Directory que crea. 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 |
-PrinterFilter
Especifica un filtro que usa este cmdlet para seleccionar las impresoras que sincroniza el conector.
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-QueryRoot
Especifica la carpeta de Active Directory desde la que este cmdlet consulta objetos, como LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
Tipo: | System.String |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RunAsAccount
Especifica la cuenta de ejecución que se va a usar al usar este conector.
Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
Posición: | 3 |
Valor predeterminado: | Operational System Account |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ScheduleDay
Especifica el día de la semana en el que se sincroniza el conector. Los valores válidos son:
- Diario
- Domingo
- Lunes
- Martes
- Miércoles
- Jueves
- Viernes
- Sábado
Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
Valores aceptados: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Posición: | Named |
Valor predeterminado: | Daily |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ScheduleHour
Especifica la hora en la que el conector inicia la sincronización. El valor debe ser un número de cero (0) a 23.
Tipo: | System.Int32 |
Posición: | Named |
Valor predeterminado: | 2 |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SCSession
Especifica un objeto que representa la sesión en un servidor de administración de Service Manager.
Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SyncNow
Hace que el conector de Active Directory inicie un ciclo de sincronización.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-UserFilter
Especifica el filtro que se usa para seleccionar los usuarios a los que sincroniza el conector.
Debe especificar el valor en forma de filtro de Active Directory.
Por ejemplo, el siguiente valor para este parámetro incluye en los usuarios de sincronización cuyos givenName comienzan por a
:
(givenname=a*)
Tipo: | System.String |
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
None.
No se puede canalizar la entrada a este cmdlet.
Salidas
None.
Este cmdlet no genera ninguna salida.