Update-AzSynapseWorkspace

Modül:

Az.Synapse

Synapse Analytics çalışma alanını Güncelleştirmeler.

Syntax

Update-AzSynapseWorkspace
      [-ResourceGroupName <String>]
      -Name <String>
      [-Tag <Hashtable>]
      [-SqlAdministratorLoginPassword <SecureString>]
      [-ManagedVirtualNetwork <PSManagedVirtualNetworkSettings>]
      [-EncryptionKeyName <String>]
      [-UserAssignedIdentityInEncryption <String>]
      [-UseSystemAssignedIdentityInEncryption <Object>]
      [-GitRepository <PSWorkspaceRepositoryConfiguration>]
      [-UserAssignedIdentityAction <UserAssignedManagedIdentityActionType>]
      [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
      [-EnablePublicNetworkAccess <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzSynapseWorkspace
      -InputObject <PSSynapseWorkspace>
      [-Tag <Hashtable>]
      [-SqlAdministratorLoginPassword <SecureString>]
      [-ManagedVirtualNetwork <PSManagedVirtualNetworkSettings>]
      [-EncryptionKeyName <String>]
      [-UserAssignedIdentityInEncryption <String>]
      [-UseSystemAssignedIdentityInEncryption <Object>]
      [-GitRepository <PSWorkspaceRepositoryConfiguration>]
      [-UserAssignedIdentityAction <UserAssignedManagedIdentityActionType>]
      [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
      [-EnablePublicNetworkAccess <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzSynapseWorkspace
      -ResourceId <String>
      [-Tag <Hashtable>]
      [-SqlAdministratorLoginPassword <SecureString>]
      [-ManagedVirtualNetwork <PSManagedVirtualNetworkSettings>]
      [-EncryptionKeyName <String>]
      [-UserAssignedIdentityInEncryption <String>]
      [-UseSystemAssignedIdentityInEncryption <Object>]
      [-GitRepository <PSWorkspaceRepositoryConfiguration>]
      [-UserAssignedIdentityAction <UserAssignedManagedIdentityActionType>]
      [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
      [-EnablePublicNetworkAccess <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-AzSynapseWorkspace cmdlet'i bir Azure Synapse Analytics çalışma alanını güncelleştirir.

Örnekler

Örnek 1

Update-AzSynapseWorkspace -Name ContosoWorkspace -Tag @{'key'='value'}

Bu komutlar, belirtilen Azure Synapse Analytics çalışma alanının etiketlerini güncelleştirir.

Örnek 2

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Update-AzSynapseWorkspace -Tag @{'key'='value1'}

Bu komutlar, işlem hattı aracılığıyla belirtilen Azure Synapse Analytics çalışma alanının etiketlerini güncelleştirir.

Örnek 3

Update-AzSynapseWorkspace -ResourceId /subscriptions/21686af7-58ec-4f4d-9c68-f431f4db4edd/resourceGroups/ContosoResourceGroup/providers/Microsoft.Synapse/workspaces/ContosoWorkspace -Tag @{'key'='value2'}

Bu komutlar, kaynak kimliğine sahip işlem hattı aracılığıyla belirtilen Azure Synapse Analytics çalışma alanının etiketlerini güncelleştirir.

Örnek 4

$config = New-AzSynapseGitRepositoryConfig -RepositoryType GitHub -AccountName ContosoAccount -RepositoryName ContosoRepo -CollaborationBranch main
Update-AzSynapseWorkspace -Name ContosoWorkspace -GitRepository $config

Bu komutlar, belirtilen Azure Synapse Analytics çalışma alanı için hangi çalışma alanının bağlı olduğu Git deposunu güncelleştirir.

Örnek 5

Update-AzSynapseWorkspace -Name ContosoWorkspace -EnablePublicNetworkAccess $True

Bu komutlar, genel ağ erişimini etkinleştirmek için belirtilen Azure Synapse Analytics çalışma alanını güncelleştirir.

Örnek 6

$uamis = Get-AzUserAssignedIdentity -ResourceGroupName ContosoResourceGroup
$uamilist = New-Object System.Collections.Generic.List[string]
foreach($uami in $uamis){
	$uamilist.Add($uami.Id)
}

Update-AzSynapseWorkspace -Name ContosoWorkspace -UserAssignedIdentityAction Add -UserAssignedIdentityId $uamilist

Bu komutlar, $uamilist kullanıcı tarafından atanan yönetilen kimlikleri eklemek için çalışma alanını güncelleştirir.

Örnek 7

$uamis = Get-AzUserAssignedIdentity -ResourceGroupName ContosoResourceGroup
$uamilist = New-Object System.Collections.Generic.List[string]
foreach($uami in $uamis){
	$uamilist.Add($uami.Id)
}

Update-AzSynapseWorkspace -Name ContosoWorkspace -UserAssignedIdentityAction Remove -UserAssignedIdentityId $uamilist[0]

Bu komutlar, kullanıcı tarafından atanan yönetilen kimlikleri $uamilist[0] çalışma alanından kaldırır.

Örnek 8

$uamis = Get-AzUserAssignedIdentity -ResourceGroupName ContosoResourceGroup
$uamilist = New-Object System.Collections.Generic.List[string]
foreach($uami in $uamis){
	$uamilist.Add($uami.Id)
}

Update-AzSynapseWorkspace -Name ContosoWorkspace -UserAssignedIdentityAction Set -UserAssignedIdentityId $uamilist

Bu komutlar, geçerli kimlikleri kapsayacak $uamilist kullanıcı tarafından atanan yönetilen kimliklerle çalışma alanını güncelleştirir.

Örnek 9

##Add a temp key to the workspace
New-AzSynapseWorkspaceKey -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name TempKey -EncryptionKeyIdentifier https://contosoKeyVault.vault.azure.net/keys/TempKey

##Update the workspace and set the temp key as the TDE protector
Update-AzSynapseWorkspace -WorkspaceName ContosoWorkspace -EncryptionKeyName TempKey -UseSystemAssignedIdentityInEncryption $true

##Note, we need to create a new key version for the original encrytion key of the Azure key vault before moving to next steps. 

##Update the workspace and set the encryption key back after we created a new key version. 
Update-AzSynapseWorkspace -WorkspaceName ContosoWorkspace -EncryptionKeyName default -UseSystemAssignedIdentityInEncryption $true

##Remove the temp key
Remove-AzSynapseWorkspaceKey -WorkspaceName ContosoWorkspace -Name TempKey

Bu komutlar bir Synapse çalışma alanının şifreleme anahtarını döndürmeyi gösterir ve Azure Key Vault'a erişmek için Sistem Tarafından Atanan Yönetilen Kimlik'i kullanır.

Örnek 10

$uamis = Get-AzUserAssignedIdentity -ResourceGroupName ContosoResourceGroup
$identityId = $uamis[0].Id
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Update-AzSynapseWorkspace -UseSystemAssignedIdentityInEncryption $false -UserAssignedIdentityInEncryption $identityId
$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
--------------------                                                                                                                                        -------------------------
/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/ContosoResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uaminame                     False

Bu komutlar çalışma alanını Kullanıcı Tarafından Atanan Olarak Şifreleme Yönetilen Kimliği güncelleştirir ve anahtar kasasında depolanan müşteri tarafından yönetilen anahtarınıza erişmek için kullanıcı tarafından atanan kimlik kimliğini belirtir. Güncelleştirdikten sonra, çalışma alanının Şifreleme özelliklerini almak için arayabiliriz 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

-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

-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

-InputObject

çalışma alanı giriş nesnesi, genellikle işlem hattından geçirilir.

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

-ManagedVirtualNetwork

Yönetilen Sanal Ağ Ayarlar.

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:	False
Accept wildcard characters:	False

-ResourceGroupName

Kaynak grubu adı.

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

-ResourceId

Synapse çalışma alanının kaynak tanımlayıcısı.

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

-SqlAdministratorLoginPassword

Çalışma alanının yeni SQL yöneticisi parolası.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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:	False
Accept wildcard characters:	False

-UserAssignedIdentityAction

Çalışma alanı için kullanıcı tarafından atanan yönetilen kimlikleri eklediğinizde/kaldırdığınızda/ayarladığınızda eylem belirtilmelidir. Desteklenen eylemler şunlardır: Çalışma alanı için kullanıcı tarafından atanan yönetilen kimlikleri eklemek için Küme Ekleme Araçlarını Kaldır, Kullanıcı tarafından atanan yönetilen kimlikleri çalışma alanından kaldırmak için kaldır, Kullanıcı tarafından atanan yönetilen kimlikleri aynı anda eklemek ve kaldırmak istediğinizde Set kullanılabilir.

Type:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+UserAssignedManagedIdentityActionType
Accepted values:	Add, Remove, Set
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

PSSynapseWorkspace

Çıkışlar

PSSynapseWorkspace