Freigeben über

New-SCADConnector

  • Referenz
Modul:
System.Center.Service.Manager

Erstellt einen neuen Active Directory-Connector für 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>]

Beschreibung

Das Cmdlet New-SCADConnector erstellt einen Active Directory-Connector des Dienst-Managers.

Die folgenden Parameter sind nur verfügbar, wenn Sie Service Manager 2012 R2 UpdateRollup 6 oder höher angewendet haben.

  • ScheduleDay-
  • ScheduleHour-

Beispiele

Beispiel 1: Erstellen eines Connectors zur lokalen Domäne

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

Der erste Befehl ruft ein Run As-Konto für Workflowkonto mithilfe des cmdlets Get-SCSMRunAsAccount ab. Der Befehl speichert das Ergebnis in der variablen $RunAsAccount.

Der zweite Befehl fordert Sie mithilfe des Cmdlets Get-Credential zur Eingabe von Anmeldeinformationen auf und speichert dann die Anmeldeinformationen in der variablen $Credential.

Der letzte Befehl erstellt einen Active Directory-Connector zur lokalen Domäne, der alle Computer, Drucker, Benutzer und Benutzergruppen abruft. Der Connector ist so konfiguriert, dass er jeden Sonntag um 3:00 Uhr synchronisiert wird.

Beispiel 2: Erstellen eines Connectors mit der lokalen Domäne, die einen Benutzerfilter enthält

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

Der erste Befehl ruft ein "Als Konto ausführen" für das Workflowkonto ab und speichert ihn dann in der variablen $RunAsAccount.

Der zweite Befehl fordert Sie mithilfe des Cmdlets Get-Credential zur Eingabe von Anmeldeinformationen auf und speichert dann die Anmeldeinformationen in der variablen $Credential.

Mit dem letzten Befehl wird ein Active Directory-Connector für die lokale Domäne erstellt, der nur die Benutzerkonten abruft, die mit dem Buchstaben E beginnen.

Parameter

-ADCredential

Gibt die Anmeldeinformationen an, die verwendet werden sollen, wenn dieses Cmdlet eine Verbindung mit dem Domänencontroller herstellt.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerFilter

Gibt einen Filter an, der die Computer auswählt, die der Connector synchronisiert. Der Filter muss als Active Directory-Filter angegeben werden. Der folgende Filter enthält beispielsweise alle Computer, die mit win in der Synchronisierung beginnen:

(name=win*)

Typ:System.String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt den Namen des Computers an, auf dem der System Center Data Access-Dienst ausgeführt wird. Das benutzerkonto, das im parameter Credential angegeben ist, muss über Zugriffsrechte für den angegebenen Computer verfügen.

Typ:System.String[]
Position:Named
Standardwert:Localhost
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:System.Management.Automation.SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt die Anmeldeinformationen an, die dieses Cmdlet zum Herstellen einer Verbindung mit dem Server verwendet, auf dem der System Center Data Access-Dienst ausgeführt wird. Das angegebene Benutzerkonto muss über Zugriffsrechte für diesen Server verfügen.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Verbinder an.

Typ:System.String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt die Anzeigenameneigenschaft des Verbinders an.

Typ:System.String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Enable

Gibt an, ob dieses Cmdlet den Connector aktiviert oder deaktiviert.

Typ:System.Boolean
Position:Named
Standardwert:True
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpandGroups

Gibt an, dass dieses Cmdlet rekursiv Mitglieder der Gruppen enthält, die vom UserFilter Parameter angegeben werden.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt an, dass dieses Cmdlet den von ihr erstellten Active Directory-Connector zurückgibt. Sie können dieses Objekt an andere Cmdlets übergeben.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrinterFilter

Gibt einen Filter an, den dieses Cmdlet verwendet, um die Drucker auszuwählen, die der Connector synchronisiert.

Typ:System.String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QueryRoot

Gibt den Active Directory-Ordner an, aus dem dieses Cmdlet Objekte abfragt, z. B. LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.

Typ:System.String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsAccount

Gibt das RunAs-Konto an, das bei Verwendung dieses Connectors verwendet werden soll.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:3
Standardwert:Operational System Account
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScheduleDay

Gibt den Wochentag an, an dem der Connector synchronisiert wird. Gültige Werte sind:

  • Täglich
  • Sonntag
  • Montag
  • Dienstag
  • Mittwoch
  • Donnerstag
  • Freitag
  • Samstag
Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Zulässige Werte:Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardwert:Daily
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScheduleHour

Gibt die Stunde an, zu der der Connector die Synchronisierung startet. Der Wert muss eine Zahl zwischen Null (0) und 23 sein.

Typ:System.Int32
Position:Named
Standardwert:2
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Objekt an, das die Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SyncNow

Bewirkt, dass der Active Directory-Connector einen Synchronisierungszyklus startet.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserFilter

Gibt den Filter an, der verwendet wird, um die Benutzer auszuwählen, die vom Connector synchronisiert werden sollen. Sie müssen den Wert in Form eines Active Directory-Filters angeben. Der folgende Wert für diesen Parameter enthält beispielsweise die Synchronisierungsbenutzer, deren givenName- mit abeginnt:

(givenname=a*)

Typ:System.String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:System.Management.Automation.SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None.

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

None.

Dieses Cmdlet generiert keine Ausgabe.