Add-SPProfileSyncConnection

Fügt eine Synchronisierungsverbindung hinzu.

Syntax

Add-SPProfileSyncConnection
   [-ProfileServiceApplication] <SPServiceApplicationPipeBind>
   -ConnectionDomain <String>
   -ConnectionForestName <String>
   -ConnectionPassword <SecureString>
   -ConnectionSynchronizationOU <String>
   -ConnectionUserName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-ConnectionClaimIDMapAttribute <String>]
   [-ConnectionClaimProviderIdValue <String>]
   [-ConnectionClaimProviderTypeValue <String>]
   [-ConnectionNamingContext <String>]
   [-ConnectionPort <Int32>]
   [-ConnectionServerName <String>]
   [-ConnectionUseSSL <Boolean>]
   [-WhatIf]
   [-ConnectionFilterOutUnlicensed <Boolean>]
   [-ConnectionUseDisabledFilter <Boolean>]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet wurde in SharePoint Server mit Service Pack 1 (SP1) und SharePoint Foundation mit Service Pack 1 (SP1) eingeführt.

Mit dem Add-SPProfileSyncConnection-Cmdlet fügen Sie eine Benutzerprofil-Synchronisierungsverbindung hinzu.

Weitere Informationen zu Profilsynchronisierungsverbindungen finden Sie unter

Dieses Cmdlet funktioniert nur mit Active Directory-Synchronisierungsverbindungen.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

--------------------BEISPIEL--------------------

Add-SPProfileSyncConnection -ProfileServiceApplication 888ds256-9ad9-53a9-f135-99eecd245670b -ConnectionForestName "fabrikam.com"-ConnectionDomain "Fabrikam" -ConnectionUserName "Testupa" -ConnectionPassword convertto-securestring "Password1" -asplaintext -force -ConnectionSynchronizationOU "OU=SharePoint Users,DC=fabrikam,DC=com"

In diesem Beispiel wird der fabrikam-Domäne, die eine bestimmte Benutzerprofildienst-Anwendung verwendet, ein Benutzer hinzugefügt.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimIDMapAttribute

Gibt die vom Forderungsanbieter verwendete Forderungs-ID an, d. h. "samAccountName".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimProviderIdValue

Gibt die Forderungsanbieter-ID oder den Namen für einen Authentifizierungstyp an, während eine Webanwendung konfiguriert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimProviderTypeValue

Gibt den Authentifizierungsforderungsanbieter an, der verwendet wird, um die Namen der Benutzerprofilkonten zu verschlüsseln, z. B. "Windows/Forms" usw. Das heißt, wenn sich ein Benutzer mit dem angegebenen Authentifizierungstyp anmeldet, kann ein Profil gefunden werden, indem die mit einer Forderung verschlüsselten Anmeldeinformationen nachgeschlagen werden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionDomain

Gibt den NetBIOS-Namen der Domäne an, zu der Sie eine Verbindung herstellen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionFilterOutUnlicensed

Nicht verwenden.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionForestName

Gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) der Gesamtstruktur an, zu der Sie eine Verbindung herstellen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionNamingContext

Gibt den Namenskontext des Verzeichnisinformationsstruktur an, zu der eine Verbindung hergestellt werden soll.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionPassword

Gibt das Kennwort des Kontos an, das zum Herstellen der Verbindung zu dem Verzeichnis verwendet wird.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionPort

Gibt den Port an, der zum Herstellen der Verbindung zu dem Verzeichnisdienst verwendet werden soll. Der Standardport ist 389.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionServerName

Gibt den Namen des Domänencontrollers an, zu dem eine Verbindung hergestellt werden soll.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionSynchronizationOU

Gibt die Organisationseinheit (organizational unit, OU) auf oberster Ebene an, die synchronisiert werden soll. Der Wert muss ein Domänenname sein, und Sie können nur einen Container pro Befehl einschließen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUseDisabledFilter

Filtert deaktivierte Konten heraus.

Hinweis

Dadurch werden nur Konten heraus gefiltert, die sich vor dem Import in einem deaktivierten Zustand befinden. Konten, die nach dem Importieren deaktiviert wurden, werden nicht herausfiltert.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUserName

Gibt den Benutzernamen an, der für die Synchronisierungsverbindung verwendet werden soll.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUseSSL

Gibt an, ob die Verbindung zum Verzeichnisdienst über SSL hergestellt werden muss.

Gültige Werte sind $True und $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileServiceApplication

Gibt den Namen der Benutzerprofildienst-Anwendung an.

Type:SPServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019