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

az storagesync sync-group server-endpoint

  • 参考

注意

此参考是 Azure CLI（版本 2.55.0 或更高版本）的存储同步扩展的一部分。 该扩展将在首次运行 az storagesync sync-group server-endpoint 命令时自动安装。 详细了解扩展。

管理服务器终结点。

命令

名称 说明 类型 状态
az storagesync sync-group server-endpoint create

创建新的服务器终结点。

 扩展 GA
az storagesync sync-group server-endpoint delete

删除给定的服务器终结点。

 扩展 GA
az storagesync sync-group server-endpoint list

列出同步组中的所有服务器终结点。

 扩展 GA
az storagesync sync-group server-endpoint show

显示给定服务器终结点的属性。

 扩展 GA
az storagesync sync-group server-endpoint update

更新给定服务器终结点的属性。

 扩展 GA
az storagesync sync-group server-endpoint wait

将 CLI 置于等待状态，直到满足服务器终结点的条件。

 扩展 GA

az storagesync sync-group server-endpoint create

创建新的服务器终结点。

az storagesync sync-group server-endpoint create --name
                                                 --registered-server-id
                                                 --server-local-path
                                                 --storage-sync-service
                                                 --sync-group-name
                                                 [--cloud-tiering {off, on}]
                                                 [--no-wait]
                                                 [--offline-data-transfer {off, on}]
                                                 [--offline-data-transfer-share-name]
                                                 [--resource-group]
                                                 [--tier-files-older-than-days]
                                                 [--volume-free-space-percent]

示例

在同步组“SampleSyncGroup”中创建新的服务器终结点“SampleServerEndpoint”。

az storagesync sync-group server-endpoint create --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup" --name "SampleServerEndpoint" --server-id 91beed22-7e9e-4bda-9313-fec96cf286e0 \
--server-local-path "d:\abc" --cloud-tiering "off" --volume-free-space-percent 80 --tier-files-older-than-days 20 \
--offline-data-transfer "on" --offline-data-transfer-share-name "myfileshare"

必需参数

--name -n

服务器终结点的名称。

--registered-server-id --server-id

已注册服务器的资源 ID 或 GUID。

--server-local-path

已注册服务器的本地路径。

--storage-sync-service

存储同步服务的名称或 ID。

--sync-group-name

同步组的名称。

可选参数

--cloud-tiering

启用或禁用云分层的开关。 通过云分层可以将不常使用或访问的文件分层到 Azure 文件。

接受的值: off, on
--no-wait

不等待长时间运行的操作完成。

默认值: False
--offline-data-transfer

用于启用或禁用脱机数据传输的开关。 通过脱机数据传输，可以使用替代方法（如 Azure Data Box）将大量文件传输到 Azure 中，而无需网络。

接受的值: off, on
--offline-data-transfer-share-name

用于脱机传输数据的 Azure 文件共享的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--tier-files-older-than-days

文件早于分层的天数。

--volume-free-space-percent

要在服务器终结点所在的卷上保留的可用空间量。 例如，如果有一个服务器终结点的卷上的卷可用空间设置为 50%，则约有一半数据会分层为 Azure 文件。 不管是否启用云分层，Azure 文件共享在同步组中始终具有完整的数据副本。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storagesync sync-group server-endpoint delete

删除给定的服务器终结点。

az storagesync sync-group server-endpoint delete --name
                                                 --storage-sync-service
                                                 --sync-group-name
                                                 [--no-wait]
                                                 [--resource-group]
                                                 [--yes]

示例

删除服务器终结点“SampleServerEndpoint”。

az storagesync sync-group server-endpoint delete --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup" --name "SampleServerEndpoint"

必需参数

--name -n

服务器终结点的名称。

--storage-sync-service

存储同步服务的名称或 ID。

--sync-group-name

同步组的名称。

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--yes -y

不提示确认。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storagesync sync-group server-endpoint list

列出同步组中的所有服务器终结点。

az storagesync sync-group server-endpoint list --storage-sync-service
                                               --sync-group-name
                                               [--resource-group]

示例

列出同步组“SampleSyncGroup”中的所有服务器终结点。

az storagesync sync-group server-endpoint list --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup"

必需参数

--storage-sync-service

存储同步服务的名称或 ID。

--sync-group-name

同步组的名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storagesync sync-group server-endpoint show

显示给定服务器终结点的属性。

az storagesync sync-group server-endpoint show --name
                                               --storage-sync-service
                                               --sync-group-name
                                               [--resource-group]

示例

显示服务器终结点“SampleServerEndpoint”的属性。

az storagesync sync-group server-endpoint show --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup" --name "SampleServerEndpoint"

必需参数

--name -n

服务器终结点的名称。

--storage-sync-service

存储同步服务的名称或 ID。

--sync-group-name

同步组的名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storagesync sync-group server-endpoint update

更新给定服务器终结点的属性。

az storagesync sync-group server-endpoint update --name
                                                 --storage-sync-service
                                                 --sync-group-name
                                                 [--cloud-tiering {off, on}]
                                                 [--no-wait]
                                                 [--offline-data-transfer {off, on}]
                                                 [--offline-data-transfer-share-name]
                                                 [--resource-group]
                                                 [--tier-files-older-than-days]
                                                 [--volume-free-space-percent]

示例

更新服务器终结点“SampleServerEndpoint”的属性。

az storagesync sync-group server-endpoint update --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup" --name "SampleServerEndpoint" --cloud-tiering "off" \
--volume-free-space-percent "100" --tier-files-older-than-days "0" \
--offline-data-transfer "off"

必需参数

--name -n

服务器终结点的名称。

--storage-sync-service

存储同步服务的名称或 ID。

--sync-group-name

同步组的名称。

可选参数

--cloud-tiering

启用或禁用云分层的开关。 通过云分层可以将不常使用或访问的文件分层到 Azure 文件。

接受的值: off, on
--no-wait

不等待长时间运行的操作完成。

默认值: False
--offline-data-transfer

用于启用或禁用脱机数据传输的开关。 通过脱机数据传输，可以使用替代方法（如 Azure Data Box）将大量文件传输到 Azure 中，而无需网络。

接受的值: off, on
--offline-data-transfer-share-name

用于脱机传输数据的 Azure 文件共享的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--tier-files-older-than-days

文件早于分层的天数。

--volume-free-space-percent

要在服务器终结点所在的卷上保留的可用空间量。 例如，如果有一个服务器终结点的卷上的卷可用空间设置为 50%，则约有一半数据会分层为 Azure 文件。 不管是否启用云分层，Azure 文件共享在同步组中始终具有完整的数据副本。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storagesync sync-group server-endpoint wait

将 CLI 置于等待状态，直到满足服务器终结点的条件。

az storagesync sync-group server-endpoint wait --name
                                               --resource-group
                                               --storage-sync-service-name
                                               --sync-group-name
                                               [--created]
                                               [--custom]
                                               [--deleted]
                                               [--exists]
                                               [--interval]
                                               [--timeout]
                                               [--updated]

示例

将 CLI 置于等待状态，直到创建服务器终结点的条件。

az storagesync sync-group server-endpoint wait --resource-group "SampleResourceGroup" \
--storage-sync-service "SampleStorageSyncService" --sync-group-name \
"SampleSyncGroup" --name "SampleServerEndpoint" --created

必需参数

--name -n

服务器终结点的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--storage-sync-service-name

存储同步服务资源的名称。

--sync-group-name

同步组资源的名称。

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False
--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False
--exists

等待资源存在。

默认值: False
--interval

轮询间隔（以秒为单位）。

默认值: 30
--timeout

最大等待（以秒为单位）。

默认值: 3600
--updated

等到 provisioningState 更新为“Succeeded”。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。