Backup-ASDatabase-Cmdlet
Sichern Sie eine mehrdimensionale oder tabellarische Analysis Services-Datenbank in einer Analysis Services-Sicherungsdatei (.abf).
Syntax
Backup-ASDatabase [-BackupFile] <string> [-Name] <string> [-AllowOverwrite <SwitchParameter>] [-BackupRemotePartitions <SwitchParameter>] [-ApplyCompression <SwitchParameter>] [-FilePassword <SecureString>] [-Locations <Microsoft.AnalysisServices.BackupLocation[]>] [-Server <string>] [-Credential <PSCredential>] [<CommonParameters>]
Backup-ASDatabase –Database <Microsoft.AnalysisServices.Database> [-AllowOverwrite <SwitchParameter>] [-BackupRemotePartitions <SwitchParameter>] [-ApplyCompression <SwitchParameter>] [-FilePassword <SecureString>] [-Locations <Microsoft.AnalysisServices.BackupLocation[]>] [-Server <string>] [-Credential <PSCredential>] [<CommonParameters>]
Beschreibung
Ermöglicht es einem Analysis Services-Systemadministrator, eine mehrdimensionale oder tabellarische Datenbank in einer Sicherungsdatei zu sichern. Wenn Sie keinen Speicherort angeben, wird der Standardsicherungsspeicherort verwendet, der während des Setups angegeben wurde.
Gesicherte Dateien können verschlüsselt werden. Verwenden Sie "–FilePassword", um die Datei zu verschlüsseln. Wenn Sie die Datei später wiederherstellen, müssen Sie dasselbe Kennwort angeben, das Sie zum Verschlüsseln angegeben haben.
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 Sicherung erstellen zu können.
Parameter
-BackupFile <string>
Gibt den Pfad und den Namen der Sicherungsdatei an. Wenn Sie nur einen Dateinamen ohne Pfad angeben, wird der Standardsicherungsspeicherort verwendet. Dieser Parameter wird nur mit dem -Name-Parameter verwendet.
Erforderlich? |
true |
Position? |
0 |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Name <string>
Gibt die Analysis Services-Datenbank an, die gesichert werden soll. Sie können eine Datenbank entweder mit dem -Database-Parameter oder mit dem -Name-Parameter angeben, wenn Sie im Namen als Zeichenfolge übergeben möchten.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-AllowOverwrite <SwitchParameter>
Überschreibt eine Sicherungsdatei mit dem gleichen Namen.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-BackupRemotePartitions <SwitchParameter>
Gibt an, ob Remotepartitionen in der Sicherung enthalten sind.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ApplyCompression<SwitchParameter>
Gibt an, ob die Sicherungsdatei komprimiert wird.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-FilePassword <SecureString>
Gibt ein Kennwort an, das für die Verschlüsselung der Sicherungsdatei verwendet werden soll.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
|
Pipelineeingabe akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Locations <Microsoft.AnalysisServices.BackupLocation[]>
Gibt die Position an, an der die Sicherungsdatei gespeichert wird.
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 |
-Database <Microsoft.AnalysisServices.Database[]>
Gibt ein Analysis Services-Datenbankobjekt an, das gesichert werden soll. Sie können eine Datenbank mithilfe entweder mit dem -Database-Parameter oder mit dem –Name-Parameter angeben. Verwenden Sie –Database, wenn Sie über die Pipeline den Datenbanknamen weitergeben möchten.
Erforderlich? |
true |
Position? |
benannt |
Standardwert |
|
Pipelineeingabe akzeptieren? |
true |
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 |
Microsoft.AnalysisServices.Database Sie können mehrere Datenbanken übergeben, die Sie sichern möchten, z. B. alle Datenbanken einer bestimmten Instanz. |
Ausgaben |
Keine. |
Beispiel 1
PS SQLSERVER:\SQLAS\Localhost\default >backup-asdatabase awdb-20110930.abf “Adventure Works” -AllowOverwrite -ApplyCompression
Dieser Befehl sichert die Adventure Works-Datenbank in einer ABF-Datei am Standardsicherungsspeicherort. Wenn eine Datei des gleichen Namens am Speicherort vorhanden ist, wird sie überschrieben.
Beispiel 2
PS SQLSERVER:\SQLAS\Localhost\default >$AWDB = get-item “databases\Adventure Works”
PS SQLSERVER:\SQLAS\Localhost\default >Backup-asdatabase –database:$AWDB –AllowOverwrite
Dieser Befehl verwendet –Database statt -Backupfile und -Name. Verwenden Sie den –Database-Parameter, wenn Sie den Datenbanknamen an das Cmdlet weitergeben möchten.
Beispiel 3
PS SQLSERVER:\SQLAS\Localhost\default\databases >dir * | backup-asdatabase
Dieser Befehl sichert alle Datenbanken auf dem lokalen Server.
Beispiel 4
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 > backup-asdatabase –backupfile test.abf –name contoso_retail –filepassword:$pwd server myremoteserver
PS SQLSERVER:\SQLAS\Localhost\default >$pwd.Dispose()
PS SQLSERVER:\SQLAS\Localhost\default >Remove-Variable –Name pwd
Linie 1 und 2 werden verwendet, um ein Kennwort aufzufordern, das dazu dient, die Datei zu verschlüsseln.
Linie 3 sichert die Beispieldatenbank "Contoso_Retail" auf einem Remote-Analysis Services-Server in einer Analysis Services-Sicherungsdatei mit dem Namen "test.abf", die sich auch auf dem Remoteserver befindet. Die Datei wird im Standardsicherungsordner der Standardinstanz gespeichert.
Mit Linie 4 und 5 wird das Kennwort entfernt.