New-AzSynapseWorkspace

Başvuru

Modül:: Az.Synapse

Synapse Analytics çalışma alanı oluşturur.

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

Description

New-AzSynapseWorkspace cmdlet'i bir Azure Synapse Analytics çalışma alanı oluşturur.

Örnekler

Örnek 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

Bu komut, ContosoResourceGroup adlı kaynak grubunda ContosoAdlGen Depolama Veri Deposu'nun kullanıldığı ContosoWorkspace adlı bir Synapse Analytics çalışma alanı oluşturur.

Örnek 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

İlk komut yönetilen bir sanal ağ yapılandırması oluşturur. Ardından rest yöntemleri, yapılandırmayı kullanarak yeni bir Synapse çalışma alanı oluşturur.

Örnek 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

İlk komut yönetilen bir sanal ağ yapılandırması oluşturur. Ardından geri kalan yöntemler yapılandırmayı kullanarak yönetilen sanal ağın etkinleştirildiği ve genel ağ erişiminin etkinleştirildiği yeni bir Synapse çalışma alanı oluşturur.

Örnek 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

Bu komut, ContosoResourceGroup adlı kaynak grubunda ContosoAdlGen Depolama Veri Deposu'nun kullanıldığı ContosoWorkspace adlı bir Synapse Analytics çalışma alanı oluşturur. Çalışma alanı ContosoRepo adlı bir Git Deposuna bağlıdır.

Örnek 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

Bu komut ContosoResourceGroup adlı kaynak grubunda ContosoAdlGen Depolama Veri Deposu'nun kullanıldığı ContosoWorkspace adlı bir Synapse Analytics çalışma alanı oluşturur ve ContosoResourceGroup ResourceGroup'tan alan kullanıcı tarafından atanan yönetilen kimlikleri çalışma alanına ekler.

Örnek 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

Bu komut, ContosoResourceGroup adlı kaynak grubunda ContosoAdlGen Depolama Veri Deposu'nu kullanan ContosoWorkspace adlı bir Synapse Analytics çalışma alanı oluşturur ve belirtilen anahtar tanımlayıcısı ile müşteri tarafından yönetilen anahtarla çift şifrelemeyi etkinleştirir ve Yönetilen Kimliği Sistem Atanmış olarak ayarlar. Oluşturma işleminden sonra, çalışma alanının Şifreleme özelliklerini almak için öğesini çağırabiliriz Get-AzSynapseWorkspace .

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultDataLakeStorageAccountName

Varsayılan ADLS 2. Nesil depolama hesabı adı.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultDataLakeStorageFilesystem

Varsayılan ADLS 2. Nesil dosya sistemi.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnablePublicNetworkAccess

Çalışma alanına genel ağ erişimini etkinleştirin veya devre dışı bırakın. Olası değerler şunlardır: 'Enabled', 'Disabled'

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionKeyIdentifier

Anahtar tanımlayıcısı şu biçimde olmalıdır: https://{keyvaultname}.vault.azure.net/keys/{keyname}.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionKeyName

Çalışma alanı şifreleme anahtarı adı.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GitRepository

Git Deposu Ayarlar. Çalışma alanı işlem hatlarınızdaki çalışma için kaynak denetimi ve işbirliği için depoya çalışma alanı Bağlan

Type:	PSWorkspaceRepositoryConfiguration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Kaynağın oluşturulması gereken Azure bölgesi.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagedResourceGroupName

Yardımcı kaynakları barındıran bir kapsayıcı. Ad belirtilebilirken varsayılan olarak oluşturulur. Bu alanın ResourceGroupName ile aynı olmaması gerektiğini unutmayın

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagedVirtualNetwork

Azure Synapse çalışma alanı için ayrılmış Synapse tarafından yönetilen sanal ağın adı.

Type:	PSManagedVirtualNetworkSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Synapse çalışma alanının adı.

Type:	String
Aliases:	WorkspaceName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Kaynak grubu adı.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SqlAdministratorLoginCredential

SQL yöneticisi kimlik bilgileri.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Kaynakla ilişkilendirilmiş bir dize,etiket dizesi sözlüğü.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserAssignedIdentityId

Çalışma alanı için kullanıcı tarafından atanan yönetilen kimlik kimliği.

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserAssignedIdentityInEncryption

Çalışma Alanı Şifrelemesi'nde kullanılan kullanıcı tarafından atanan kimlik kaynağı kimliği

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSystemAssignedIdentityInEncryption

Çalışma Alanı Şifrelemesi'nde sistem tarafından atanan kimliğin kullanılıp kullanılmayacağını belirtme

Type:	Object
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

String

Hashtable

PSCredential

Çıkışlar

PSSynapseWorkspace

Aracılığıyla paylaş