你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzSynapseNotebook
在工作区中创建或更新笔记本。
语法
Set-AzSynapseNotebook
-WorkspaceName <String>
[-Name <String>]
[-FolderPath <String>]
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseNotebook
-WorkspaceName <String>
[-Name <String>]
[-FolderPath <String>]
-SparkPoolName <String>
[-ExecutorSize <String>]
-ExecutorCount <Int32>
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseNotebook
-WorkspaceObject <PSSynapseWorkspace>
[-Name <String>]
[-FolderPath <String>]
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzSynapseNotebook
-WorkspaceObject <PSSynapseWorkspace>
[-Name <String>]
[-FolderPath <String>]
-SparkPoolName <String>
[-ExecutorSize <String>]
-ExecutorCount <Int32>
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-AzSynapseNotebook cmdlet 在工作区中创建或更新笔记本。
示例
示例 1
Set-AzSynapseNotebook -WorkspaceName ContosoWorkspace -DefinitionFile "C:\\samples\\notebook.ipynb"
WorkspaceName : ContosoWorkspace
Properties : Microsoft.Azure.Commands.Synapse.Models.PSNotebook
Name : notebook此命令从名为 ContosoWorkspace 的工作区中的笔记本文件 notebook.ipynb 创建或更新笔记本。
示例 2
Set-AzSynapseNotebook -WorkspaceName ContosoWorkspace -DefinitionFile "C:\\samples\\notebook.ipynb" -FolderPath ContosoFolder此命令从笔记本文件 notebook.ipynb 创建或更新笔记本，并指定一个文件夹路径 ContosoFolder，其中笔记本将放置在名为 ContosoWorkspace 的工作区中。
示例 3
Set-AzSynapseNotebook -WorkspaceName ContosoWorkspace -DefinitionFile "C:\\samples\\notebook.ipynb" -FolderPath ContosoFolder/SubFolder此命令从笔记本文件 notebook.ipynb 创建或更新笔记本，并指定多级文件夹路径 ContosoFolder/SubFolder，其中笔记本将放置在名为 ContosoWorkspace 的工作区中。
示例 4
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Set-AzSynapseNotebook -DefinitionFile "C:\\samples\\notebook.ipynb"此命令通过管道从名为 ContosoWorkspace 的工作区中的笔记本文件 notebook.ipynb 创建或更新笔记本。
示例 5
Set-AzSynapseNotebook -WorkspaceName ContosoWorkspace -DefinitionFile "C:\\samples\\notebook.ipynb" -SparkPoolName ContosoSparkPool -ExecutorCount 2此命令从附加到 ContosoSparkPool 的笔记本文件 notebook.ipynb 创建或更新笔记本，并在名为 ContosoWorkspace 的工作区中使用 2 个执行程序。
参数
-AsJob
在后台运行 cmdlet
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefinitionFile
JSON 文件路径。
| 类型: | String |
| 别名: | File |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExecutorCount
在作业的指定 Spark 池中分配的执行程序数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExecutorSize
要用于作业的指定 Spark 池中分配的执行程序的核心和内存数。
| 类型: | String |
| 接受的值: | Small, Medium, Large, XLarge, XXLarge, XXXLarge |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FolderPath
此笔记本所在的文件夹。 如果指定多级路径（如 [rootFolder/subFolder]），则笔记本将显示在底部级别。 如果未指定，此笔记本将显示在根级别。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
笔记本名称。
| 类型: | String |
| 别名: | NotebookName |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SparkPoolName
Synapse Spark 池的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WorkspaceName
Synapse 工作区的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WorkspaceObject
工作区输入对象，通常通过管道传递。
| 类型: | PSSynapseWorkspace |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
