.png)
.png)
New-SPUser
Betrifft:
Fügt einer SharePoint-Website einen vorhandenen Benutzer mit den definierten Berechtigungen hinzu.
New-SPUser [-UserAlias] <String> -Web <SPWebPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Email <String>] [-Group <SPGroupPipeBind>] [-PermissionLevel <String[]>] [-SiteCollectionAdmin <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Parameter
| Parameter | Erforderlich | Typ | Beschreibung | ||
|---|---|---|---|---|---|
| UserAlias | Erforderlich | System.String | |||
| Web | Erforderlich | Microsoft.SharePoint.PowerShell.SPWebPipeBind | Gibt die URL oder GUID der Website an, auf der der Benutzer erstellt werden soll. Bei dem Typ muss es sich um eine gültige URL im Format http://Servername oder eine GUID im Format 1234-5678-9876-0987 handeln. | ||
| AssignmentCollection | Optional | Microsoft.SharePoint.PowerShell.SPAssignmentCollection | 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.
| ||
| Confirm | Optional | System.Management.Automation.SwitchParameter | Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters | ||
| DisplayName | Optional | System.String | Gibt eine Zeichenfolge an, die den Anzeigenamen des Benutzers enthält. Bei dem Typ muss es sich um einen gültigen Benutzernamen handeln, z. B. Joe. | ||
| | Optional | System.String | Gibt die E-Mail-Adresse des neuen Benutzers an. Bei dem Typ muss es sich um eine gültige E-Mail-Adresse im Format jemand@contoso.com handeln. | ||
| Group | Optional | Microsoft.SharePoint.PowerShell.SPGroupPipeBind | Gibt die Benutzergruppe an, zu der der neue Benutzer gehört. | ||
| PermissionLevel | Optional | System.String[] | Fügt einen Benutzer einer Berechtigungsstufe hinzu. Diese muss eine gültige Berechtigungsstufe für die Webanwendung sein, z. B. Full Control, Read, Contribute oder All. | ||
| SiteCollectionAdmin | Optional | System.Management.Automation.SwitchParameter | Gibt an, ob der Benutzer der Websitesammlung als Administrator hinzugefügt werden soll. | ||
| WhatIf | Optional | System.Management.Automation.SwitchParameter | Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters |
Hinweis: Detaillierte Beschreibung
Mit dem New-SPUser-Cmdlet wird einer SharePoint-Website ein vorhandener Benutzer mit den definierten Berechtigungen hinzugefügt. Der Benutzer verfügt über die angegebenen Berechtigungen auf allen Unterwebsites, die Berechtigungen erben. Das Benutzerkonto muss bereits im Verzeichnis verfügbar sein.
Wenn sich die Umgebung im Active Directory-Modus befindet, muss der Benutzer bereits in den Active Directory-Domänendiensten (Active Directory Domain Services, AD DS) vorhanden sein, und nur der UserAlias-Parameter muss angegeben werden, während alle anderen Felder aus AD DS abgerufen werden. Wenn nur ein Alias angegeben wird und die Farm sich im Active Directory-Kontoerstellungsmodus befindet, muss auch der Email-Parameter angegeben werden.
Eingabetypen
Rückgabetypen
------------------BEISPIEL 1----------------------
PS> New-SPUser – UserAlias ‘Contoso\Jdow’–displayname ‘Jane Dow’ –web http://contoso.com
In diesem Beispiel wird der Domäne Contoso ein neuer Benutzer namens Jane Dow hinzugefügt.
------------------BEISPIEL 2----------------------
Get-SPWeb http://sitename | New-SPUser –UserAlias Contoso\Jdow
In diesem Beispiel wird Contoso\Jdow allen Websites in der Websitesammlung http://sitename hinzugefügt. Da die Websitesammlung vererbte Berechtigungen verwendet, muss nur die Website auf oberster Ebene geändert werden.
