你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzSynapseNotebook

参考

模块:: Az.Synapse

在工作区中创建或更新笔记本。

语法

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

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefinitionFile

JSON 文件路径。

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

-ExecutorCount

在作业的指定 Spark 池中分配的执行程序数。

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

-ExecutorSize

要用于作业的指定 Spark 池中分配的执行程序的核心和内存数。

Type:	String
Accepted values:	Small, Medium, Large, XLarge, XXLarge, XXXLarge
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FolderPath

此笔记本所在的文件夹。如果指定多级路径（如 [rootFolder/subFolder]），则笔记本将显示在底部级别。如果未指定，此笔记本将显示在根级别。

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

-Name

笔记本名称。

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

-SparkPoolName

Synapse Spark 池的名称。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceName

Synapse 工作区的名称。

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

-WorkspaceObject

工作区输入对象，通常通过管道传递。

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

输入

PSSynapseWorkspace

输出

PSNotebookResource