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.