New-SCADConnector

Referencia

Módulo:: System.Center.Service.Manager

Crea un nuevo conector de Active Directory en Service Manager.

Syntax

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 Service Manager.

Los parámetros siguientes solo están disponibles si ha aplicado Service Manager paquete acumulativo de actualizaciones 6 o versiones posteriores de 2012 R2.

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 con la letra E.

Parámetros

-ADCredential

Especifica la credencial que se va a usar cuando este cmdlet se conecta al controlador de dominio.

Type:	System.Management.Automation.PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerFilter

Especifica un filtro que selecciona los equipos que sincroniza el conector. El filtro debe especificarse como un filtro de Active Directory. Por ejemplo, el siguiente filtro incluye todos los equipos que comienzan por win en la sincronización:

(name=win*)

Type:	System.String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Especifica el nombre del equipo donde 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.

Type:	System.String[]
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	System.Management.Automation.SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	System.Management.Automation.PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Especifica una descripción para el conector.

Type:	System.String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Especifica la propiedad de nombre para mostrar del conector.

Type:	System.String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enable

Indica si este cmdlet habilita o deshabilita el conector.

Type:	System.Boolean
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpandGroups

Especifica que este cmdlet incluye de forma recursiva los miembros de los grupos especificados por el parámetro UserFilter .

Type:	System.Management.Automation.SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Indica que este cmdlet devuelve el conector de Active Directory que crea. Puede pasar este objeto a otros cmdlets.

Type:	System.Management.Automation.SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrinterFilter

Especifica un filtro que usa este cmdlet para seleccionar las impresoras que sincroniza el conector.

Type:	System.String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	System.String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsAccount

Especifica la cuenta RunAs que se debe utilizar cuando se usa este conector.

Type:	Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:	3
Default value:	Operational System Account
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Accepted values:	Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	Daily
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	System.Int32
Position:	Named
Default value:	2
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

Especifica un objeto que representa la sesión en un servidor de administración de Service Manager.

Type:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncNow

Hace que el conector de Active Directory inicie un ciclo de sincronización.

Type:	System.Management.Automation.SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserFilter

Especifica el filtro que se utiliza para seleccionar los usuarios que se van a sincronizar con el conector. Debe especificar el valor en forma de un filtro de Active Directory. Por ejemplo, el siguiente valor para este parámetro incluye en los usuarios de sincronización cuyo nombreDeDeSeminio comienza por a:

(givenname=a*)

Type:	System.String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	System.Management.Automation.SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None.

No se puede canalizar la entrada a este cmdlet.

Salidas