New-AzSynapseWorkspace
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
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Aliases: | cf |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultDataLakeStorageAccountName
Varsayılan ADLS 2. Nesil depolama hesabı adı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultDataLakeStorageFilesystem
Varsayılan ADLS 2. Nesil dosya sistemi.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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'
Tür: | Boolean |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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}.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionKeyName
Çalışma alanı şifreleme anahtarı adı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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
Tür: | PSWorkspaceRepositoryConfiguration |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Kaynağın oluşturulması gereken Azure bölgesi.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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ı.
Tür: | PSManagedVirtualNetworkSettings |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Synapse çalışma alanının adı.
Tür: | String |
Aliases: | WorkspaceName |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Kaynak grubu adı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SqlAdministratorLoginCredential
SQL yöneticisi kimlik bilgileri.
Tür: | PSCredential |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Kaynakla ilişkilendirilmiş bir dize,etiket dizesi sözlüğü.
Tür: | Hashtable |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | List<T>[String] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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
Tür: | Object |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Aliases: | wi |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |