Compartir a través de


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 debe tener derechos de acceso al equipo especificado.

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.