Restore-ASDatabase-Cmdlet

Artikel
05/07/2013

Stellt eine mehrdimensionale oder tabellarische Datenbank aus einer Analysis Services-Sicherungsdatei (.abf) wieder her.

Syntax

Restore-ASDatabase [-RestoreFile] <string> [-Name] <string> [-AllowOverwrite <SwitchParameter>] Locations <Microsoft.AnalysisServices.RestoreLocation[]>] [-Security <Microsoft.AnalysisServices.RestoreSecurity>] [-Password <System.SecureString>] [-StorageLocation <System.string>] [-Server <string>] [-Credential <PSCredential>] [<CommonParameters>]

Beschreibung

Ermöglicht es einem Analysis Services-Systemadministrator, eine mehrdimensionale oder tabellarische Datenbank aus einer Sicherungsdatei wiederherzustellen. Wenn die Datei, die Sie wiederherstellen, verschlüsselt war, können Sie das Kennwort, das zum Verschlüsseln der Datei verwendet wurde, mit "-FilePassword" angeben.

Dieses Cmdlet unterstützt den –Credential-Parameter, der verwendet werden kann, wenn Sie die Analysis Services-Instanz für HTTP-Zugriff konfigurierten. Der –Credential-Parameter verwendet ein PSCredential-Objekt, das eine Windows-Benutzeridentität bereitstellt. Beim Herstellen einer Verbindung mit Analysis Services nimmt wird die Identität dieses Benutzers dann von IIS angenommen. Die Identität muss über Systemadministratorberechtigungen für die Analysis Services-Instanz verfügen, um eine Datei wiederherstellen zu können.

Parameter

-RestoreFile <string>

Gibt den Pfad und den Namen der wiederherzustellenden Datei an. Wenn Sie nur den Dateinamen ohne Pfad angeben, wird vom Standardsicherungsspeicherort ausgegangen.

Erforderlich?	true
Position?	0
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Name <string>

Gibt die Analysis Services-Datenbank an, die wiederhergestellt werden soll.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-AllowOverwrite <SwitchParameter>

Überschreibt eine Datenbank, die den gleichen Namen und Speicherort verwendet.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Locations <Microsoft.AnalysisServices.RestoreLocation[]>

Gibt den Remotestandort der Partitionen an, die wiederhergestellt werden sollen.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Security <Microsoft.AnalysisServices.RestoreSecurity>

Stellt die für den Wiederherstellungsvorgang verwendeten Sicherheitseinstellungen dar. Gültige Werte sind CopyAll, SkipMembership, IgnoreSecurity. CopyAll stellt Rollen und Mitgliedschaft wieder her. SkipMembership erstellt nur die Rolle neu. IgnoreSecurity stellt die Datenbank ohne Rollen wieder her.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Password <SecureString>

Gibt ein Kennwort an, das verwendet werden soll, um eine verschlüsselte Sicherungsdatei wiederherzustellen. Sie müssen das Kennwort, das bei der ursprünglichen Verschlüsselung der Datei verwendet wurde, angeben.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-StorageLocation <string>

Gibt den Datenbankspeicherort an. Dies ist der Speicherort der Datenbankdateien im Dateisystem. Legen Sie diesen Parameter fest, wenn Sie nicht den Standardspeicherort verwenden (den Sicherungsordner der Zielinstanz).

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Server <string>

Gibt die Analysis Services-Instanz an, zu der das Cmdlet eine Verbindung herstellt und auf der es ausgeführt wird. Wenn kein Servername angegeben wird, wird eine Verbindung mit localhost hergestellt. Für Standardinstanzen geben Sie nur den Servernamen an. Verwenden Sie für benannte Instanzen das Format "servername\instanzenname". Verwenden Sie für HTTP-Verbindungen das Format "http[s]://server[:port]/virtualdirectory/msmdpump.dll".

Erforderlich?	false
Position?	benannt
Standardwert	localhost
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Credential <PSCredential>

Gibt ein PSCredential-Objekt an, das einen Windows-Benutzernamen und ein -Kennwort angegeben werden. Geben Sie diesen Parameter nur an, wenn die Analysis Services-Instanz mit der Standardauthentifizierung für HTTP-Zugriff konfiguriert wird. Für systemeigene Verbindungen, die integrierte Sicherheit verwenden, wird dieser Parameter ignoriert.

Wenn dieser Parameter vorhanden ist, werden die Anmeldeinformationen, die es bereitstellt, an die Verbindungszeichenfolge angefügt. Beim Herstellen einer Verbindung mit Analysis Services wird die Identität dieses Benutzers dann von IIS angenommen. Wenn keine Anmeldeinformationen angegeben sind, wird das Windows-Standardkonto des Benutzers, der das Tool ausführt, verwendet.

Um diesen Parameter zu verwenden, erstellen Sie zuerst mit Get-Credential ein PSCredential-Objekt, um den Benutzernamen und das Kennwort anzugeben (z. B. $Cred=Get-Credential “adventure-works\admin”). Sie können dann dieses Objekt an den –Credential-Parameter (-Credential:$Cred weitergeben.

Weitere Informationen über Authentifizierung und die Verwendung von Anmeldeinformationen finden Sie unter Analysis Services PowerShell. Weitere Informationen zum HTTP-Zugriff finden Sie unter Konfigurieren von HTTP-Zugriff auf Analysis Services unter Internetinformationsdienste (IIS) 7.0.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	True (ByValue)
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter About_CommonParameters.

Eingaben und Ausgaben

Mit dem Eingabetyp wird festgelegt, welchen Typ von Objekten Sie über die Pipeline an das Cmdlet übergeben können. Der Rückgabetyp bezeichnet den Typ der vom Cmdlet zurückgegebenen Objekte.

Eingaben

System.string

Sie können Zeichenfolgenwerte an das Cmdlet weitergeben.

Ausgaben

Keine.

Beispiel 1

PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase awtest.abf testawrestoredb –security:CopyAll

Dieser Befehl stellt eine Analysis Services-Sicherungsdatei ("awtest.abf") im lokalen Sicherungsordner der Standardinstanz in einer lokalen Analysis Services wieder her. Der Datenbankname muss nicht vorhanden sein; in diesem Fall wird der Datenbankname als Teil des Wiederherstellungsvorgangs angegeben. Wenn Sie "-Security:CopyAll" hinzufügen, werden Rollen und Rollenmitgliedschaften aus der Sicherungsdatenbank in der neu wiederhergestellten Datenbank aufgefüllt.

Beispiel 2

PS SQLSERVER:\SQLAS\Localhost\default > $pwd = read-host –AsSecureString –Prompt “Password” 
PS SQLSERVER:\SQLAS\Localhost\default > $pwd -is [System.IDisposable] 
PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase –restorefile testdb.abf –name AWTEST2 –password:$pwd
PS SQLSERVER:\SQLAS\Localhost\default >$pwd.Dispose()
PS SQLSERVER:\SQLAS\Localhost\default >Remove-Variable –Name pwd

Linie 1 und 2 werden verwendet, um das Kennwort aufzufordern, das verwendet wurde, die Datei zu verschlüsseln.

Linie 3 stellt eine verschlüsselte Analysis Services-Sicherungsdatei (testdb.abf) von einem Remotesicherungsordner auf einer Analysis Services-Standardinstanz wieder her.

Mit Linie 4 und 5 wird das Kennwort entfernt.

Beispiel 3

PS SQLSERVER:\SQLAS\localhost\default> restore-asdatabase –restorefile “\\myremoteserver\backups\testdb.abf” –name Contoso_Retail –server myremoteserver –storagelocation “\\myremoteserver\restoreDBFiles”

Dieser Befehl stellt eine verschlüsselte Analysis Services-Sicherungsdatei (testdb.abf) in einem Remotesicherungsordner auf einer Remote-Analysis Services Standardinstanz wieder her. Der –StorageLocations-Parameter wird verwendet, um die Datenbankdateien an einem nicht standardmäßigen Speicherort einzufügen, in diesem Fall eine freigegebene Datei mit dem Namen "restoreDBfiles".

Freigeben über