New-AzSynapseWorkspace

Syntaxe

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>]

Description

L’applet de commande New-AzSynapseWorkspace crée un espace de travail Azure Synapse Analytics.

Exemples

Exemple 1

$password = ConvertTo-SecureString -String "****" -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

Cette commande crée un espace de travail Synapse Analytics nommé ContosoWorkspace qui utilise le magasin de données ContosoAdlGenStorage, dans le groupe de ressources nommé ContosoResourceGroup.

Exemple 2

$config = New-AzSynapseManagedVirtualNetworkConfig -PreventDataExfiltration -AllowedAadTenantIdsForLinking ContosoTenantId
$password = ConvertTo-SecureString -String "****" -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

La première commande crée une configuration de réseau virtuel managé. Ensuite, les méthodes rest utilisent la configuration pour créer un espace de travail Synapse.

Exemple 3

$config = New-AzSynapseManagedVirtualNetworkConfig -PreventDataExfiltration -AllowedAadTenantIdsForLinking ContosoTenantId
$password = ConvertTo-SecureString -String "****" -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

La première commande crée une configuration de réseau virtuel managé. Ensuite, les méthodes rest utilisent la configuration pour créer un espace de travail Synapse avec un réseau virtuel managé activé et un accès au réseau public activé.

Exemple 4

$password = ConvertTo-SecureString -String "****" -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

Cette commande crée un espace de travail Synapse Analytics nommé ContosoWorkspace qui utilise le magasin de données ContosoAdlGenStorage, dans le groupe de ressources nommé ContosoResourceGroup. Et l’espace de travail est connecté à un dépôt Git appelé ContosoRepo.

Exemple 5

$password = ConvertTo-SecureString -String "****" -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

Cette commande crée un espace de travail Synapse Analytics nommé ContosoWorkspace qui utilise le magasin de données ContosoAdlGenStorage, dans le groupe de ressources nommé ContosoResourceGroup, et ajoute des identités managées affectées par l’utilisateur qui accèdent de ResourceGroup ContosoResourceGroup à l’espace de travail.

Exemple 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

Cette commande crée un espace de travail Synapse Analytics nommé ContosoWorkspace qui utilise le magasin de données ContosoAdlGenStorage, dans le groupe de ressources nommé ContosoResourceGroup, et active le double chiffrement avec la clé gérée par le client avec l’identificateur de clé spécifié et définit l’identité managée comme affectée par le système. Après la création, nous pouvons appeler Get-AzSynapseWorkspace pour obtenir les propriétés de chiffrement de l’espace de travail.

Paramètres

-AsJob

-Confirm

-DefaultDataLakeStorageAccountName

-DefaultDataLakeStorageFilesystem

-DefaultProfile

-EnablePublicNetworkAccess

-EncryptionKeyIdentifier

-EncryptionKeyName

-GitRepository

-Location

-ManagedResourceGroupName

-ManagedVirtualNetwork

-Name

-ResourceGroupName

-SqlAdministratorLoginCredential

-Tag

-UserAssignedIdentityId

-UserAssignedIdentityInEncryption

-UseSystemAssignedIdentityInEncryption

-WhatIf

Entrées

String

Hashtable

PSCredential

Sorties

PSSynapseWorkspace