New-AzSynapseWorkspace

Referência

Módulo:: Az.Synapse

Cria um espaço de trabalho do Synapse Analytics.

Sintaxe

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

O cmdlet New-AzSynapseWorkspace cria um espaço de trabalho do Azure Synapse Analytics.

Exemplos

Exemplo 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

Este comando cria um espaço de trabalho Synapse Analytics chamado ContosoWorkspace que usa o ContosoAdlGenStorage Data Store, no grupo de recursos chamado ContosoResourceGroup.

Exemplo 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

O primeiro comando cria uma configuração de rede virtual gerenciada. Em seguida, os métodos rest usam a configuração para criar um novo espaço de trabalho Synapse.

Exemplo 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

O primeiro comando cria uma configuração de rede virtual gerenciada. Em seguida, os métodos restantes usam a configuração para criar um novo espaço de trabalho Synapse com rede virtual gerenciada habilitada e acesso à rede pública habilitado.

Exemplo 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

Este comando cria um espaço de trabalho Synapse Analytics chamado ContosoWorkspace que usa o ContosoAdlGenStorage Data Store, no grupo de recursos chamado ContosoResourceGroup. E o espaço de trabalho está conectado a um repositório Git chamado ContosoRepo.

Exemplo 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

Este comando cria um espaço de trabalho Synapse Analytics chamado ContosoWorkspace que usa o ContosoAdlGenStorage Data Store, no grupo de recursos chamado ContosoResourceGroup, e adiciona identidades gerenciadas atribuídas ao usuário que passam de ResourceGroup ContosoResourceGroup para o espaço de trabalho.

Exemplo 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

Este comando cria um espaço de trabalho Synapse Analytics chamado ContosoWorkspace que usa o Armazenamento de Dados ContosoAdlGenStorage, no grupo de recursos chamado ContosoResourceGroup, e habilita a criptografia dupla com chave gerenciada pelo cliente com identificador de chave especificado e define Identidade Gerenciada como Sistema Atribuído. Após a criação, podemos chamar Get-AzSynapseWorkspace para obter as propriedades de criptografia do espaço de trabalho.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultDataLakeStorageAccountName

O nome padrão da conta de armazenamento ADLS Gen2.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DefaultDataLakeStorageFilesystem

O sistema de arquivos ADLS Gen2 padrão.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EnablePublicNetworkAccess

Habilite ou desabilite o acesso à rede pública ao espaço de trabalho. Os valores possíveis incluem: 'Ativado', 'Desativado'

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EncryptionKeyIdentifier

O identificador de chave deve estar no formato de: https://{keyvaultname}.vault.azure.net/keys/{keyname}.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EncryptionKeyName

O nome da chave de criptografia do espaço de trabalho.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-GitRepository

Configurações do repositório Git. Conecte o espaço de trabalho ao repositório para controle do código-fonte e colaboração para o trabalho em seus pipelines de espaço de trabalho

Tipo:	PSWorkspaceRepositoryConfiguration
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Location

Região do Azure onde o recurso deve ser criado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ManagedResourceGroupName

Um contêiner que contém recursos auxiliares. Criado por padrão enquanto o nome pode ser especificado. Observe que esse campo não deve ser o mesmo com ResourceGroupName

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ManagedVirtualNetwork

Nome de uma rede virtual gerenciada pelo Synapse dedicada ao espaço de trabalho do Azure Synapse.

Tipo:	PSManagedVirtualNetworkSettings
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome do espaço de trabalho Sinapse.

Tipo:	String
Aliases:	WorkspaceName
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-SqlAdministratorLoginCredential

Credenciais de administrador SQL.

Tipo:	PSCredential
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Tag

Um dicionário string,string de tags associadas ao recurso.

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-UserAssignedIdentityId

ID de identidade gerenciada atribuída pelo usuário para o espaço de trabalho.

Tipo:	List<T>[String]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UserAssignedIdentityInEncryption

ID do recurso de identidade atribuído pelo usuário usado na criptografia de espaço de trabalho

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UseSystemAssignedIdentityInEncryption

especificando se a identidade atribuída ao sistema deve ser usada na Criptografia de Espaço de Trabalho ou não

Tipo:	Object
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

String

Hashtable

PSCredential

Saídas

PSSynapseWorkspace

Partilhar via