Set-AzSynapseIntegrationRuntime
Atualiza um runtime de integração.
Sintaxe
Set-AzSynapseIntegrationRuntime
[-ResourceGroupName <String>]
-WorkspaceName <String>
-Name <String>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-PublicIP <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
[-ResourceGroupName <String>]
-WorkspaceName <String>
-Name <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-Name <String>
-WorkspaceObject <PSSynapseWorkspace>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-PublicIP <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-Name <String>
-WorkspaceObject <PSSynapseWorkspace>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-ResourceId <String>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-PublicIP <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-ResourceId <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-InputObject <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-PublicIP <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseIntegrationRuntime
-InputObject <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Set-AzSynapseIntegrationRuntime atualiza um runtime de integração com parâmetros específicos.
Exemplos
Exemplo 1
Set-AzSynapseIntegrationRuntime -WorkspaceName ContosoWorkspace -Name 'test-selfhost-ir' -Description 'New description'O cmdlet atualiza a descrição do runtime de integração chamado 'test-selfhost-ir'.
Exemplo 2
Set-AzSynapseIntegrationRuntime -WorkspaceName ContosoWorkspace -Name 'test-selfhost-ir' `
-SharedIntegrationRuntimeResourceId '/subscriptions/b3ee3a7f-7614-4644-ad07-afa832620b4b/resourceGroups/rg-test-dfv2/providers/Microsoft.DataFactory/factories/test-df-eu2/integrationruntimes/test-selfhost-ir' -Type "SelfHosted"O cmdlet adiciona o workspace para usar o runtime de integração compartilhada. Ao usar -SharedIntegrationRuntimeResourceId o parâmetro, o -Type também deve ser incluído. Observe que o workspace precisa receber permissão para usar o runtime de integração antes de executar o cmdlet.
Parâmetros
-AuthKey
A chave de autenticação do runtime de integração auto-hospedada.
| Tipo: | SecureString |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CatalogAdminCredential
A credencial de administrador do banco de dados de catálogo do runtime de integração.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CatalogPricingTier
O tipo de preço do banco de dados de catálogo do runtime de integração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CatalogServerEndpoint
O ponto de extremidade do servidor de banco de dados de catálogo do runtime de integração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataFlowComputeType
Tipo de computação do cluster de fluxo de dados que executará o trabalho de fluxo de dados.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataFlowCoreCount
Contagem de núcleos do cluster de fluxo de dados que executará o trabalho de fluxo de dados.
| Tipo: | Nullable<T>[Int32] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataFlowTimeToLive
Configuração de vida útil (em minutos) do cluster de fluxo de dados que executará o trabalho de fluxo de dados.
| Tipo: | Nullable<T>[Int32] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataProxyIntegrationRuntimeName
O nome do Integration Runtime auto-hospedado que é usado como um proxy.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataProxyStagingLinkedServiceName
O nome do Serviço Vinculado do Armazenamento de Blobs do Azure que faz referência ao armazenamento de dados de preparo a ser usado ao mover dados entre o Auto-Hospedado e o Azure-SSIS Integration Runtime.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DataProxyStagingPath
O caminho no armazenamento de dados de preparo a ser usado ao mover dados entre Runtimes de Integração Auto-Hospedados e Azure-SSIS, um contêiner padrão será usado se não for especificado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
A descrição do runtime de integração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Edition
A edição do runtime de integração do SSIS, que pode ser Standard ou Enterprise, o padrão é Standard se não for especificado.
| Tipo: | String |
| Valores aceitos: | Standard, Enterprise |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ExpressCustomSetup
A configuração personalizada expressa para o runtime de integração do SSIS que pode ser usada para definir configurações e componentes de terceiros sem script de configuração personalizado.
| Tipo: | ArrayList |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Não peça confirmação.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
O objeto de tempo de execução de integração.
| Tipo: | PSIntegrationRuntime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LicenseType
O tipo de licença que você deseja selecionar para o IR do SSIS. Existem dois tipos: LicenseIncluded ou BasePrice. Se você estiver qualificado para o preço do AHUB (Benefício de Uso Híbrido do Azure), selecione BasePrice. Caso contrário, selecione LicenseIncluded.
| Tipo: | String |
| Valores aceitos: | LicenseIncluded, BasePrice |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Location
A descrição do runtime de integração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MaxParallelExecutionsPerNode
Contagem máxima de execução paralela por nó para um runtime de integração dedicado gerenciado.
| Tipo: | Nullable<T>[Int32] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
O nome do runtime de integração.
| Tipo: | String |
| Aliases: | IntegrationRuntimeName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NodeCount
Contagem de nós de destino do runtime de integração.
| Tipo: | Nullable<T>[Int32] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NodeSize
O tamanho do nó do runtime de integração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PublicIP
Os endereços IP públicos estáticos que o runtime de integração usará.
| Tipo: | String[] |
| Aliases: | PublicIPs |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ResourceGroupName
Nome do grupo de recursos.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ResourceId
Identificador de recurso do runtime de integração do Synapse.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SetupScriptContainerSasUri
O URI SAS do contêiner de blob do Azure que contém o script de instalação personalizado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SharedIntegrationRuntimeResourceId
A ID do recurso do runtime de integração auto-hospedada compartilhada.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Subnet
O nome da sub-rede na VNet.
| Tipo: | String |
| Aliases: | SubnetName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Type
O tipo de runtime de integração.
| Tipo: | String |
| Valores aceitos: | Managed, SelfHosted |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VNetId
A ID da VNet à qual o runtime de integração ingressará.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WorkspaceName
Nome do workspace do Synapse.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WorkspaceObject
objeto de entrada do workspace, geralmente passado pelo pipeline.
| Tipo: | PSSynapseWorkspace |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
Entradas
Saídas
Azure PowerShell