New-AzSynapseWorkspace
Létrehoz egy Synapse Analytics-munkaterületet.
Syntax
Default (Alapértelmezett)
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
A New-AzSynapseWorkspace parancsmag létrehoz egy Azure Synapse Analytics-munkaterületet.
Példák
1. példa
$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
Ez a parancs létrehoz egy ContosoWorkspace nevű Synapse Analytics-munkaterületet, amely a ContosoAdlGenStorage Adattárat használja a ContosoResourceGroup nevű erőforráscsoportban.
2. példa
$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
Az első parancs létrehoz egy felügyelt virtuális hálózati konfigurációt. Ezután a többi metódus a konfigurációval hoz létre egy új Synapse-munkaterületet.
3. példa
$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
Az első parancs létrehoz egy felügyelt virtuális hálózati konfigurációt. Ezután a többi metódus a konfigurációval létrehoz egy új Synapse-munkaterületet engedélyezett felügyelt virtuális hálózattal és engedélyezett nyilvános hálózati hozzáféréssel.
4. példa
$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
Ez a parancs létrehoz egy ContosoWorkspace nevű Synapse Analytics-munkaterületet, amely a ContosoAdlGenStorage Adattárat használja a ContosoResourceGroup nevű erőforráscsoportban. A munkaterület pedig egy ContosoRepo nevű Git-adattárhoz csatlakozik.
5. példa
$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
Ez a parancs létrehoz egy ContosoWorkspace nevű Synapse Analytics-munkaterületet, amely a ContosoAdlGenStorage adattárat használja a ContosoResourceGroup nevű erőforráscsoportban, és hozzáadja a felhasználó által hozzárendelt felügyelt identitásokat, amelyek a ResourceGroup ContosoResourceGroup-ból a munkaterületre kerülnek.
6. példa
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
Ez a parancs létrehoz egy ContosoWorkspace nevű Synapse Analytics-munkaterületet, amely a ContosoAdlGenStorage adattárat használja a ContosoResourceGroup nevű erőforráscsoportban, és engedélyezi a kettős titkosítást az ügyfél által felügyelt kulccsal a megadott kulcsazonosítóval, és a felügyelt identitást rendszer hozzárendeltként állítja be. A létrehozás után meghívhatjuk Get-AzSynapseWorkspace a munkaterület titkosítási tulajdonságait.
Paraméterek
-AsJob
Parancsmag futtatása a háttérben
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Cf
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-DefaultDataLakeStorageAccountName
Az alapértelmezett ADLS Gen2 tárfiók neve.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-DefaultDataLakeStorageFilesystem
Az alapértelmezett ADLS Gen2 fájlrendszer.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-EnablePublicNetworkAccess
Nyilvános hálózati hozzáférés engedélyezése vagy letiltása a munkaterülethez. A lehetséges értékek a következők: "Engedélyezve", "Letiltva"
Paramétertulajdonságok
Típus: Boolean
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-EncryptionKeyIdentifier
A kulcsazonosító formátuma: https://{keyvaultname}.vault.azure.net/keys/{keyname}.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-EncryptionKeyName
A munkaterület titkosítási kulcsának neve.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-GitRepository
A Git-adattár beállításai. Munkaterület csatlakoztatása az adattárhoz forrásvezérlés és együttműködés céljából a munkaterület-folyamatokon végzett munkához
Paramétertulajdonságok
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Location
Azure-régió, ahol létre kell hozni az erőforrást.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-ManagedResourceGroupName
Kiegészítő erőforrásokat tartalmazó tároló. A név megadásakor alapértelmezés szerint létrejön. Vegye figyelembe, hogy ez a mező nem lehet azonos a ResourceGroupName mezővel
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-ManagedVirtualNetwork
Az Azure Synapse-munkaterülethez dedikált Synapse által felügyelt virtuális hálózat neve.
Paramétertulajdonságok
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Name
A Synapse-munkaterület neve.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Munkahely neve
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-ResourceGroupName
Az erőforráscsoport neve.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-SqlAdministratorLoginCredential
SQL-rendszergazdai hitelesítő adatok.
Paramétertulajdonságok
Típus: PSCredential
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-Tag
Az erőforráshoz társított címkék sztring- és sztringszótára.
Paramétertulajdonságok
Típus: Hashtable
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-UserAssignedIdentityId
Felhasználó által hozzárendelt felügyelt identitásazonosító a munkaterülethez.
Paramétertulajdonságok
Típus: List<T> [ String ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-UserAssignedIdentityInEncryption
A munkaterület titkosításában használt felhasználó által hozzárendelt identitáserőforrás-azonosító
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-UseSystemAssignedIdentityInEncryption
annak megadása, hogy a rendszer által hozzárendelt identitást használja-e a Workspace Encryptionben, vagy sem
Paramétertulajdonságok
Típus: Object
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna.
A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Wi
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek