SharePoint-Farm PassPhrase anpassen

PassPhrase wiederherstellen

Immer wieder kommt es vor, dass man einen neuen Server in eine bestehende SharePoint Farm aufnehmen muss. Oft passiert es dabei, dass der Zugang unmöglich ist, weil die PassPhrase vergessen wurde oder gar nicht bekannt ist.

Nachfolgend wird kurz beschrieben, wie das beschriebene Problem gelöst werden mittels PowerShell gelöst werden kann und die PassPhrase sich neu setzen läßt. Ein Weg die alte auszulesen ist meines Wissens nicht möglich.

Vorgehen:

Als erstes startet man die PowerShell und lädt das SharePoint PowerShellPlugin mit

add-pssnapin microsoft.shahrepoint.powershell

Anschließend speichert man die PassPhrase in eine variable mit SecureString mittels

$pass = ConvertTo-SecureString -AsPlainText -Force

Convertierung SecureString

Dies startet einen Dialog in dem man die Password String eingeben muss und mit der Enter-Taste bestätigt.

Danach setzt man die PassPhrase neu mit

Set-SPPassPhrase -PassPhrase $pass -Confirm

Setzen der neuen PAssPhrase

Anschließend gibt man im Dialog die Phrase nochmals ein, schließt die Eingabe mit der Enter-Taste ab und bestätigt dies nochmals mit Y.

Nun kann man mit der neuen Phrase einen Server in die Farm aufnehmen.

 

Contentdatenbank umbenennen

Umbenennen einer Contentdatenbank

Das Umbenennen einer Contentdatenbank ist in manchen Fällen nötig. Zum Beispiel, wenn die automatisch generierte Datenbank im Namen eine GUID enthält. s.h. Bild

Ansicht Contendatenbank mit GUID

 

1.Schritt

Dazu startet man die PowerShell und lädt das Sharepoint-Modul mit

add-pssnapin microsoft.sharepoint.powershell

Anschließend listet man die jeweilige Datenbank für die einzelnen Webapplicationen auf.

get-spwebapplication | select-object Url, ContentDatabases | Format-List

Ansicht der Contentdatenbanken pro Webapplication

2.Schritt

Als nächsten Schritt wird die Datenbank abgehangen. Das erfolgt mittels

dismount-spcontentdatabase Datenbankname

Dismount Contentdatenbank

dies muss mit Y bestätigt werden..

3.Schritt

Anschließend kann man die Contentdatenbank im SQL Management Studio mittels Query umbenennen.

Umbenennen einer Contendatenbank im SQL Management Studio

4.Schritt

Abschließend muss die Contentdatenbank mittels

mount-spcontentdatabase „neuer Datenbankname“ -Webapplication URL

wieder angefügt werden.

Anhängen der Contentdatenbank

Suchhostcontroller-Dienst

Suchhostcontroller-Dienst startet nicht richtig

Oft passiert es, das der Suchhostcontroller-Dienst in der Zentraladministration dauerhaft auf „wird gestartet“ steht. Dieses Problem habe ich schon des öfteren bei SharePoint 2013 Farmen erlebt. Der Fehler im Suchhostcontroller-Dienst lässt sich auch nicht über einen Neustart des Servers beheben. Außerdem gibt es keine Möglichkeit diesen über die Zentraladministration wieder in einen definierten Zustand zu bringen. Einzig der Einsatz der PowerShell schaft hier Abhilfe.

Als erstes startet man die PowerShell als Farm-Administrator. Anschließend gibt man den Befehl

add-pssnapin microsoft.sharepoint.powershell

ein, um das PowerShell Snapin für SharePoint zu laden. Danach holt man sich den Dienst, welcher im „wird gestartet“ festhängt. Dies erfolgt mittels

$service = get-spserviceinstance | where {$_.Status -like „Provisioning“}

Nun kann der Dienst mit

$service.unprovision()

beendet und mit

$service.provision()

neu gestartet werden.

 

Eine Übersicht findet man unter Microsoft SPServiceInstance Referenz

Farm-Backup mit PowerShell

Voraussetzung für ein Farm-Backup:

  • Administrativer Zugriff am SharePoint
  • UNC Freigabe zur Sicherung der Daten
  • optional Zugriff auf die Aufgabenplanung am Server zur Automatisierung

Durchführung:

Als erstes muss der SharePoint Service Account und SQL Service Account auf der UNC Freigabe berechtigt werden.
Anschließend führt man die PowerShell auf einem SharePoint Server der Farm als Administrator aus und führt man das PowerShell SnapIn für SharePoint mit nachfolgendem Befehl.

add-pssnapin microsoft.sharepoint.powershell

Danach kann das Backup durchgeführt werden.

backup-spfarm -Directory UNC-Freigabe -BackupMethod Full

Abschließend sollte die Logfile auf der UNC Freigabe geprüft werden.