Aracılığıyla paylaş

Update-AzSynapseWorkspace

  • Başvuru
Modül:
Az.Synapse

Synapse Analytics çalışma alanını güncelleştirir.

Sözdizimi

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

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

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EncryptionKeyName

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 çalışma alanını depoya bağlama

Tür:PSWorkspaceRepositoryConfiguration
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

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

Tür:PSSynapseWorkspace
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ManagedVirtualNetwork

Yönetilen Sanal Ağ Ayarları.

Tür:PSManagedVirtualNetworkSettings
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

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

Tür:String
Diğer adlar:WorkspaceName
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Kaynak grubu adı.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceId

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

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SqlAdministratorLoginPassword

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

Tür:SecureString
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Tag

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

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+UserAssignedManagedIdentityActionType
Kabul edilen değerler:Add, Remove, Set
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UserAssignedIdentityId

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

Tür:List<T>[String]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UserAssignedIdentityInEncryption

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PSSynapseWorkspace

Çıkışlar

PSSynapseWorkspace