New-AzSynapseWorkspace
Erstellt einen Synapse Analytics-Arbeitsbereich.
Syntax
New-AzSynapseWorkspace
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-Tag <Hashtable>]
-DefaultDataLakeStorageAccountName <String>
-DefaultDataLakeStorageFilesystem <String>
-SqlAdministratorLoginCredential <PSCredential>
[-ManagedVirtualNetwork <PSManagedVirtualNetworkSettings>]
[-EncryptionKeyName <String>]
[-EncryptionKeyIdentifier <String>]
[-UserAssignedIdentityInEncryption <String>]
[-UseSystemAssignedIdentityInEncryption <Object>]
[-AsJob]
[-ManagedResourceGroupName <String>]
[-GitRepository <PSWorkspaceRepositoryConfiguration>]
[-EnablePublicNetworkAccess <Boolean>]
[-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-AzSynapseWorkspace erstellt einen Azure Synapse Analytics-Arbeitsbereich.
Beispiele
Beispiel 1
$password = ConvertTo-SecureString "Password123!" -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential ("ContosoUser", $password)
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds
Mit diesem Befehl wird ein Synapse Analytics-Arbeitsbereich namens "ContosoWorkspace" erstellt, der den Datenspeicher "ContosoAdlGenStorage" in der Ressourcengruppe "ContosoResourceGroup" verwendet.
Beispiel 2
$config = New-AzSynapseManagedVirtualNetworkConfig -PreventDataExfiltration -AllowedAadTenantIdsForLinking ContosoTenantId
$password = ConvertTo-SecureString "Password123!" -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential ("ContosoUser", $password)
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds -ManagedVirtualNetwork $config
Der erste Befehl erstellt eine verwaltete Virtuelle Netzwerkkonfiguration. Anschließend werden mit den Restmethoden die Konfiguration verwendet, um einen neuen Synapse-Arbeitsbereich zu erstellen.
Beispiel 3
$config = New-AzSynapseManagedVirtualNetworkConfig -PreventDataExfiltration -AllowedAadTenantIdsForLinking ContosoTenantId
$password = ConvertTo-SecureString "Password123!" -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential ("ContosoUser", $password)
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds -ManagedVirtualNetwork $config -EnablePublicNetworkAccess $True
Der erste Befehl erstellt eine verwaltete Virtuelle Netzwerkkonfiguration. Anschließend werden mit den rest-Methoden die Konfiguration verwendet, um einen neuen Synapse-Arbeitsbereich mit aktiviertem verwaltetem virtuellen Netzwerk und aktiviertem öffentlichen Netzwerkzugriff zu erstellen.
Beispiel 4
$password = ConvertTo-SecureString "Password123!" -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential ("ContosoUser", $password)
$config = New-AzSynapseGitRepositoryConfig -RepositoryType GitHub -AccountName ContosoAccount -RepositoryName ContosoRepo -CollaborationBranch main
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds -GitRepository $config
Mit diesem Befehl wird ein Synapse Analytics-Arbeitsbereich namens "ContosoWorkspace" erstellt, der den Datenspeicher "ContosoAdlGenStorage" in der Ressourcengruppe "ContosoResourceGroup" verwendet. Und der Arbeitsbereich ist mit einem Git-Repository namens ContosoRepo verbunden.
Beispiel 5
$password = ConvertTo-SecureString "Password123!" -AsPlainText -Force
$creds = New-Object System.Management.Automation.PSCredential ("ContosoUser", $password)
$uamis = Get-AzUserAssignedIdentity -ResourceGroupName ContosoResourceGroup
$uamilist = New-Object System.Collections.Generic.List[string]
foreach($uami in $uamis){
$uamilist.Add($uami.Id)
}
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds -UserAssignedIdentityId $uamilist
Mit diesem Befehl wird ein Synapse Analytics-Arbeitsbereich namens ContosoWorkspace erstellt, der den ContosoAdlGenStorage-Datenspeicher verwendet, in der Ressourcengruppe "ContosoResourceGroup" und dem Arbeitsbereich vom Benutzer zugewiesene verwaltete Identitäten hinzufügen.
Beispiel 6
New-AzSynapseWorkspace -ResourceGroupName ContosoResourceGroup -Name ContosoWorkspace -Location northeurope -DefaultDataLakeStorageAccountName ContosoAdlGen2Storage -DefaultDataLakeStorageFilesystem ContosoFileSystem -SqlAdministratorLoginCredential $creds -EncryptionKeyIdentifier $identifier -UseSystemAssignedIdentityInEncryption $true
$ws = Get-AzSynapseWorkspace -name ContosoWorkspace
$ws.Encryption.CustomerManagedKeyDetails.Key
Name KeyVaultUrl
---- -----------
default https://contosoKeyValut.vault.azure.net/keys/testkey
$ws = Get-AzSynapseWorkspace -name ContosoWorkspace
$ws.Encryption.CustomerManagedKeyDetails.KekIdentity
UserAssignedIdentity UseSystemAssignedIdentity
-------------------- -------------------------
True
Dieser Befehl erstellt einen Synapse Analytics-Arbeitsbereich namens ContosoWorkspace, der den ContosoAdlGenStorage-Datenspeicher verwendet, in der Ressourcengruppe "ContosoResourceGroup" und die doppelte Verschlüsselung mit vom Kunden verwaltetem Schlüssel mit dem angegebenen Schlüsselbezeichner aktivieren und verwaltete Identität als "System zugewiesen" festlegen. Nach der Erstellung können wir aufrufen Get-AzSynapseWorkspace
, um Verschlüsselungseigenschaften des Arbeitsbereichs abzurufen.
Parameter
-AsJob
Cmdlet im Hintergrund ausführen
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultDataLakeStorageAccountName
Der Standardmäßige ADLS Gen2-Speicherkontoname.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DefaultDataLakeStorageFilesystem
Das standardmäßige ADLS Gen2-Dateisystem.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliase: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EnablePublicNetworkAccess
Aktivieren oder Deaktivieren des öffentlichen Netzwerkzugriffs auf den Arbeitsbereich. Mögliche Werte sind: "Enabled", "Disabled"
Typ: | Boolean |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EncryptionKeyIdentifier
Der Schlüsselbezeichner sollte im Format von: https://{keyvaultname}.vault.azure.net/keys/{keyname}.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EncryptionKeyName
Der Name des Arbeitsbereichsverschlüsselungsschlüssels.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-GitRepository
Git Repository-Einstellungen. Verbinden des Arbeitsbereichs mit dem Repository für die Quellcodeverwaltung und Zusammenarbeit für die Arbeit an Ihren Arbeitsbereichspipelinen
Typ: | PSWorkspaceRepositoryConfiguration |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Location
Azure-Region, in der die Ressource erstellt werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ManagedResourceGroupName
Ein Container, der zusätzliche Ressourcen enthält. Wird standardmäßig erstellt, während der Name angegeben werden kann. Beachten Sie, dass dieses Feld nicht mit ResourceGroupName identisch sein darf.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ManagedVirtualNetwork
Name eines synapseverwalteten virtuellen Netzwerks, das für den Azure Synapse-Arbeitsbereich reserviert ist.
Typ: | PSManagedVirtualNetworkSettings |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Name des Synapse-Arbeitsbereichs.
Typ: | String |
Aliase: | WorkspaceName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Ressourcengruppenname
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SqlAdministratorLoginCredential
SQL-Administratoranmeldeinformationen.
Typ: | PSCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Tag
Eine Zeichenfolge, ein Zeichenfolgenwörterbuch mit Tags, die der Ressource zugeordnet sind.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-UserAssignedIdentityId
Vom Benutzer zugewiesene verwaltete Identitäts-ID für den Arbeitsbereich.
Typ: | List<T>[String] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserAssignedIdentityInEncryption
Benutzer zugewiesene Identitätsressourcen-ID, die in der Arbeitsbereichsverschlüsselung verwendet wird
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UseSystemAssignedIdentityInEncryption
Angeben, ob die vom System zugewiesene Identität in der Arbeitsbereichsverschlüsselung verwendet werden soll oder nicht
Typ: | Object |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |