New-MasterDataServicesDatabase (PowerShell)
Erstellt eine Master Data Services-Datenbank.
Syntax
New-MasterDataServicesDatabase [-Server] <Microsoft.MasterDataServices.Configuration.DatabaseServerInformation>
[-DatabaseName] <String> [-AdminAccount] <String> [-Collation <String>]
Beschreibung
New-MasterDataServicesDatabase erstellt eine Master Data Services-Datenbank. Das Cmdlet überprüft, ob die angegebene Instanz von SQL Server eine unterstützte Version und Edition ist, die die Datenbank Master Data Services hosten kann. Es überprüft darüber hinaus, dass das angegebene Konto über die Berechtigung verfügt, eine Datenbank auf dieser Instanz zu erstellen.
Parameter
-Server
Der Server-Parameter ist ein Informationsobjekt des Datenbankservers aus Get-MasterDataServicesDatabaseServerInformation. Dieses Objekt wird verwendet, um eine Verbindung mit der Instanz von SQL Server herzustellen, auf der die Datenbank Master Data Services erstellt werden kann.
Erforderlich? |
true |
Position? |
0 |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-DatabaseName
Der DatabaseName-Parameter ist eine Zeichenfolge, die den Namen der neuen Master Data Services-Datenbank angibt.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
false |
Platzhalterzeichen akzeptieren? |
false |
-AdminAccount
Der AdminAccount-Parameter ist eine Zeichenfolge, die eine Domäne und ein Windows-Konto angibt, um der neuen Master Data Services-Datenbank Berechtigung zu erteilen.
Erforderlich? |
true |
Position? |
2 |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
false |
Platzhalterzeichen akzeptieren? |
false |
-Collation
Der Collation-Parameter ist eine Zeichenfolge, die eine Sortierung für die neue Master Data Services-Datenbank angibt.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
Die Standardsortierung für den Server. |
Pipelineeingabe akzeptieren |
false |
Platzhalterzeichen akzeptieren? |
false |
Eingaben und Ausgaben
Mit 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.MasterDataServices.Configuration.DatabaseServerInformation Ein Informationsobjekt des Datenbankservers aus Get-MasterDataServicesDatabaseServerInformation. |
Ausgaben |
Keine |
Beispiele
Ausgabe
Das folgende Beispiel zeigt die Ausgabe, die zurückgegeben wird, wenn Sie dieses Cmdlet verwenden.
Name : MyDatabase
HasAccess : True
Collation : SQL_Latin1_General_CP1_CI_AS
ServiceAccount :
MdsAdministrator : MyDomain\AccountName
Server : Microsoft.MasterDataServices.Configuration.DatabaseServerInformation
IsDatabaseOwner : True
Verwenden von Variablen und benannten Parametern
In diesem Beispiel wird das Cmdlet Get-MasterDataServicesDatabaseServerInformation verwendet, um eine Variable, $-Server, festzulegen, die für den Server-Parameter im Cmdlet New-MasterDataServicesDatabase verwendet werden soll. Die Parameter sind benannte Parameter, und die Standardsortierung wird für die neue Datenbank verwendet, da keine Sortierung angegeben ist.
C:\PS> $server = Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=';
New-MasterDataServicesDatabase -Server $server
-DatabaseName 'MyDatabase' -AdminAccount 'MyDomain\AccountName';
Übergeben von Ausgaben über die Pipeline und Verwenden von benannten Parametern
In diesem Beispiel wird die Ausgabe von Get-MasterDataServicesDatabaseServerInformation über die Pipeline für den Server-Parameter in New-MasterDataServicesDatabase an New-MasterDataServicesDatabase übergeben. Die Parameter sind benannte Parameter:
C:\PS> Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=' |
New-MasterDataServicesDatabase -DatabaseName 'MyDatabase'
-AdminAccount 'MyDomain\AccountName' -Collation 'SQL_Latin1_General_CP1_CI_AS';
Verwenden von Variablen und Positionsparametern
In diesem Beispiel wird das Cmdlet Get-MasterDataServicesDatabaseServerInformation verwendet, um eine Variable, $-Server, festzulegen, die für den Server-Parameter im Cmdlet New-MasterDataServicesDatabase verwendet werden soll. Die Parameter sind Positionsparameter, und die Standardsortierung wird für die neue Datenbank verwendet, da keine Sortierung angegeben ist.
C:\PS> $server = Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=';
New-MasterDataServicesDatabase $server 'MyDatabase' 'MyDomain\AccountName';