Freigeben über

New-AzSynapseWorkspace

  • Referenz
Modul:
Az.Synapse

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
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultDataLakeStorageAccountName

Der Standardmäßige ADLS Gen2-Speicherkontoname.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultDataLakeStorageFilesystem

Das standardmäßige ADLS Gen2-Dateisystem.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionKeyIdentifier

Der Schlüsselbezeichner sollte im Format von: https://{keyvaultname}.vault.azure.net/keys/{keyname}.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionKeyName

Der Name des Arbeitsbereichsverschlüsselungsschlüssels.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-GitRepository

Git-Repository Einstellungen. Verbinden Arbeitsbereich zum Repository für Quellcodeverwaltung und Zusammenarbeit für die Arbeit an Ihren Arbeitsbereichspipelinen

Typ:PSWorkspaceRepositoryConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Azure-Region, in der die Ressource erstellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-ManagedVirtualNetwork

Name eines synapseverwalteten virtuellen Netzwerks, das für den Azure Synapse-Arbeitsbereich reserviert ist.

Typ:PSManagedVirtualNetworkSettings
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Name des Synapse-Arbeitsbereichs.

Typ:String
Aliases:WorkspaceName
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Ressourcengruppenname

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-SqlAdministratorLoginCredential

SQL-Administratoranmeldeinformationen.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Eine Zeichenfolge, ein Zeichenfolgenwörterbuch mit Tags, die der Ressource zugeordnet sind.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-UserAssignedIdentityId

Vom Benutzer zugewiesene verwaltete Identitäts-ID für den Arbeitsbereich.

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentityInEncryption

Benutzer zugewiesene Identitätsressourcen-ID, die in der Arbeitsbereichsverschlüsselung verwendet wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Hashtable

PSCredential

Ausgaben

PSSynapseWorkspace