New-SCADConnector

Crea un nuovo Active Directory Connector di Service Manager.

Sintassi

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>]

Descrizione

Il cmdlet New-SCADConnector crea un connettore di Active Directory Service Manager.

I parametri seguenti sono disponibili solo se sono state applicate Service Manager 2012 R2 Update Rollup 6 o versioni successive.

  • ScheduleDay
  • ScheduleHour

Esempio

Esempio 1: Creare un connettore per il dominio locale

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

Il primo comando ottiene un account RunAs per l'account del flusso di lavoro usando il cmdlet Get-SCSMRunAsAccount. Il comando archivia il risultato nella variabile $RunAsAccount.

Il secondo comando richiede le credenziali usando il cmdlet Get-Credential e quindi archivia le credenziali nella variabile $Credential.

Il comando finale crea un connettore Active Directory al dominio locale, che recupera tutti i computer, stampanti, utenti e gruppi di utenti. Il connettore è configurato per sincronizzare ogni domenica alle 3:00 A.M.

Esempio 2: Creare un connettore al dominio locale che include un filtro utente

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*)"

Il primo comando ottiene un account RunAs per l'account del flusso di lavoro e lo archivia nella variabile $RunAsAccount.

Il secondo comando richiede le credenziali usando il cmdlet Get-Credential e quindi archivia le credenziali nella variabile $Credential.

Il comando finale crea un connettore Active Directory al dominio locale che recupera solo gli account utente che iniziano con la lettera E.

Parametri

-ADCredential

Specifica le credenziali da usare quando questo cmdlet si connette al controller di dominio.

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

-ComputerFilter

Specifica un filtro che seleziona i computer sincronizzati dal connettore. Il filtro deve essere specificato come un filtro di Active Directory. Ad esempio, il filtro seguente include tutti i computer che iniziano con win nella sincronizzazione:

(name=win*)

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

-ComputerName

Specifica il nome del computer in cui è in esecuzione il servizio di accesso ai dati di System Center. L'account utente specificato nel parametro Credential deve avere diritti di accesso al computer specificato.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Credential

Specifica le credenziali usate da questo cmdlet per connettersi al server in cui viene eseguito il servizio Di accesso ai dati di System Center. L'account utente specificato deve disporre di diritti di accesso per tale server.

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

-Description

Specifica una descrizione per il connettore.

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

-DisplayName

Specifica la proprietà nome visualizzato del connettore.

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

-Enable

Indica se questo cmdlet abilita o disabilita il connettore.

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

-ExpandGroups

Specifica che questo cmdlet include in modo ricorsivo i membri dei gruppi specificati dal parametro UserFilter .

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

-PassThru

Indica che questo cmdlet restituisce il connettore Active Directory creato. È possibile passare questo oggetto ad altri cmdlet.

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

-PrinterFilter

Specifica un filtro usato da questo cmdlet per selezionare le stampanti sincronizzate dal connettore.

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

-QueryRoot

Specifica la cartella Active Directory da cui questo cmdlet esegue query sugli oggetti, ad esempio 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

Specifica l'account RunAs da usare quando si usa questo connettore.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:3
Default value:Operational System Account
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleDay

Specifica il giorno della settimana in cui il connettore viene sincronizzato. I valori validi sono:

  • Ogni giorno
  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Sabato
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

Specifica l'ora in cui il connettore avvia la sincronizzazione. Il valore deve essere un numero compreso tra zero (0) e 23.

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

-SCSession

Specifica un oggetto che rappresenta la sessione per un server di gestione di Service Manager.

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

-SyncNow

Determina l'avvio di un ciclo di sincronizzazione da parte dell'Active Directory Connector.

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

-UserFilter

Specifica il filtro usato per selezionare gli utenti che devono essere sincronizzati dal connettore. Devi specificare il valore sotto forma di un filtro di Active Directory. Ad esempio, il valore seguente per questo parametro include gli utenti di sincronizzazione i cui datiName iniziano con a:

(givenname=a*)

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

None.

Non è possibile inviare input tramite pipe a questo cmdlet.

Output

None.

Questo cmdlet non genera alcun output.