New-SCADConnector
Crea un nuovo connettore Active Directory 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 Active Directory di Service Manager.
I parametri seguenti sono disponibili solo se è stato applicato Service Manager 2012 R2 Update Rollup 6 o versioni successive.
- ScheduleDay
- ScheduleHour
Esempio
Esempio 1: Creare un connettore nel 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 3Il 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 nel dominio locale, che recupera tutti i computer, stampanti, utenti e gruppi di utenti. Il connettore è configurato per la sincronizzazione ogni domenica alle 3:00
Esempio 2: Creare un connettore per il 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 quindi 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 di Active Directory nel dominio locale che recupera solo gli account utente che iniziano con la lettera E.
Parametri
-ADCredential
Specifica le credenziali da utilizzare quando questo cmdlet si connette al controller di dominio.
| Tipo: | System.Management.Automation.PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ComputerFilter
Specifica un filtro che seleziona i computer sincronizzati dal connettore.
Il filtro deve essere specificato come filtro di Active Directory.
Ad esempio, il filtro seguente include tutti i computer che iniziano con win nella sincronizzazione:
(name=win*)
| Tipo: | System.String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ComputerName
Specifica il nome del computer in cui viene eseguito il servizio di accesso ai dati di System Center. L'account utente specificato nel parametro Credential deve disporre dei diritti di accesso per il computer specificato.
| Tipo: | System.String[] |
| Posizione: | Named |
| Valore predefinito: | Localhost |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | System.Management.Automation.SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 dei diritti di accesso per tale server.
| Tipo: | System.Management.Automation.PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Description
Specifica una descrizione per il connettore.
| Tipo: | System.String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DisplayName
Specifica la proprietà del nome visualizzato del connettore.
| Tipo: | System.String |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Enable
Indica se questo cmdlet abilita o disabilita il connettore.
| Tipo: | System.Boolean |
| Posizione: | Named |
| Valore predefinito: | True |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ExpandGroups
Specifica che questo cmdlet include in modo ricorsivo i membri dei gruppi specificati dal parametro UserFilter.
| Tipo: | System.Management.Automation.SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PassThru
Indica che questo cmdlet restituisce il connettore Active Directory creato. È possibile passare questo oggetto ad altri cmdlet.
| Tipo: | System.Management.Automation.SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PrinterFilter
Specifica un filtro utilizzato da questo cmdlet per selezionare le stampanti sincronizzate dal connettore.
| Tipo: | System.String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-QueryRoot
Specifica la cartella Active Directory da cui questo cmdlet esegue una query sugli oggetti, ad esempio LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
| Tipo: | System.String |
| Posizione: | 2 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RunAsAccount
Specifica l'account RunAs da usare quando si usa questo connettore.
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
| Posizione: | 3 |
| Valore predefinito: | Operational System Account |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScheduleDay
Specifica il giorno della settimana in cui il connettore viene sincronizzato. I valori validi sono:
- Quotidiano
- Domenica
- Lunedì
- Martedì
- Mercoledì
- Giovedì
- Venerdì
- Sabato
| Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
| Valori accettati: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Posizione: | Named |
| Valore predefinito: | Daily |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScheduleHour
Specifica l'ora in cui il connettore avvia la sincronizzazione. Il valore deve essere un numero compreso tra zero (0) e 23.
| Tipo: | System.Int32 |
| Posizione: | Named |
| Valore predefinito: | 2 |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SCSession
Specifica un oggetto che rappresenta la sessione in un server di gestione di Service Manager.
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SyncNow
Fa sì che il connettore Active Directory avvii un ciclo di sincronizzazione.
| Tipo: | System.Management.Automation.SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UserFilter
Specifica il filtro utilizzato per selezionare gli utenti da sincronizzare dal connettore.
È necessario specificare il valore sotto forma di filtro di Active Directory.
Ad esempio, il valore seguente per questo parametro include negli utenti di sincronizzazione il cui givenName inizia con a:
(givenname=a*)
| Tipo: | System.String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.
| Tipo: | System.Management.Automation.SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None.
Non è possibile inviare tramite pipe l'input a questo cmdlet.
Output
None.
Questo cmdlet non genera alcun output.