Update-AzSynapseWorkspace
Synapse Analytics-munkaterület frissítése.
Syntax
SetByNameParameterSet (Alapértelmezett)
Update-AzSynapseWorkspace
-Name <String>
[-ResourceGroupName <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>]
SetByResourceIdParameterSet
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
A Update-AzSynapseWorkspace parancsmag frissít egy Azure Synapse Analytics munkaterületet.
Példák
1. példa
Update-AzSynapseWorkspace -Name ContosoWorkspace -Tag @{'key'='value'}
Ez a parancs frissíti a megadott Azure Synapse Analytics munkaterület címkéinek frissítését.
2. példa
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Update-AzSynapseWorkspace -Tag @{'key'='value1'}
Ez a parancsok a megadott Azure Synapse Analytics munkaterület címkéinek frissítését hajtják végre folyamaton keresztül.
3. példa
Update-AzSynapseWorkspace -ResourceId /subscriptions/21686af7-58ec-4f4d-9c68-f431f4db4edd/resourceGroups/ContosoResourceGroup/providers/Microsoft.Synapse/workspaces/ContosoWorkspace -Tag @{'key'='value2'}
Ez a parancsok a megadott Azure Synapse Analytics munkaterület címkéinek frissítésére szolgálnak az erőforrás-azonosítóval rendelkező folyamaton keresztül.
4. példa
$config = New-AzSynapseGitRepositoryConfig -RepositoryType GitHub -AccountName ContosoAccount -RepositoryName ContosoRepo -CollaborationBranch main
Update-AzSynapseWorkspace -Name ContosoWorkspace -GitRepository $config
Ez a parancs frissíti a Git-adattárat, amelyhez a megadott Azure Synapse Analytics munkaterület csatlakozik.
5. példa
Update-AzSynapseWorkspace -Name ContosoWorkspace -EnablePublicNetworkAccess $True
Ez a parancsok frissítik a megadott Azure Synapse Analytics munkaterületet a nyilvános hálózati hozzáférés engedélyezéséhez.
6. példa
$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
Ez a parancsok frissítik a munkaterületet a felhasználó által hozzárendelt felügyelt identitások hozzáadásához a $uamilist.
7. példa
$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]
Ez a parancs eltávolítja a felhasználó által hozzárendelt felügyelt identitásokat $uamilist[0] a munkaterületről.
8. példa
$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
Ez a parancsok frissítik a munkaterületet a felhasználó által hozzárendelt felügyelt identitásokkal $uamilist, amelyek lefedik az aktuális identitásokat.
9. példa
##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 encryption 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
Ez a parancs bemutatja, hogyan forgathatja el a Synapse-munkaterület titkosítási kulcsát, és hogyan használhatja a rendszer által hozzárendelt felügyelt identitást a Azure Key Vault eléréséhez.
10. példa
$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
Ez a parancsok felhasználóhoz rendeltként frissítik a munkaterület titkosítási felügyelt identitását, és megadják a felhasználó által hozzárendelt identitásazonosítót a kulcstartóban tárolt ügyfél által felügyelt kulcs eléréséhez. A frissítés után meghívhatjuk Get-AzSynapseWorkspace a munkaterület titkosítási tulajdonságainak lekérését.
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
-DefaultProfile
A Azure 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
-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
munkaterület bemeneti objektuma, amely általában áthalad a folyamaton.
Típus: PSSynapseWorkspace
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
SetByInputObjectParameterSet
Position: Named Kötelező: True Folyamatból származó érték: True Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ManagedVirtualNetwork
Felügyelt Virtual Network beállításai.
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
SetByNameParameterSet
Position: Named Kötelező: True 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
-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
SetByNameParameterSet
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
-ResourceId
A Synapse-munkaterület erőforrás-azonosítója.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
SetByResourceIdParameterSet
Position: Named Kötelező: True 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
-SqlAdministratorLoginPassword
A munkaterület új SQL-rendszergazdai jelszava.
Paramétertulajdonságok
Típus: SecureString
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
-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: False Fennmaradó argumentumokból származó érték: False
-UserAssignedIdentityAction
A műveletet akkor kell megadni, ha felhasználó által hozzárendelt felügyelt identitásokat ad hozzá/távolít el/állít be a munkaterülethez.
A támogatott műveletek a következők: Add Remove Set Add means to add user assigned managed identityes for workspace, Remove means to remove user assigned managed identityes from workspace, Set can can you want to add and remove user assigned managed identityes at at same same.
Paramétertulajdonságok
Típus: Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+UserAssignedManagedIdentityActionType
Alapértelmezett érték: None Elfogadott értékek: Add, Remove, Set 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
-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
