az storagesync sync-group server-endpoint

注意

此參考是 Azure CLI (2.3.1 版或更新版本的 storagesync 擴充功能的一部分) 。 當您第一次執行 az storagesync sync-group server-endpoint 命令時,擴充功能會自動安裝。 深入了解延伸模組。

管理伺服器端點。

命令

az storagesync sync-group server-endpoint create

建立新的伺服器端點。

az storagesync sync-group server-endpoint delete

刪除指定的伺服器端點。

az storagesync sync-group server-endpoint list

列出同步群組中的所有伺服器端點。

az storagesync sync-group server-endpoint show

顯示指定伺服器端點的屬性。

az storagesync sync-group server-endpoint update

更新指定伺服器端點的屬性。

az storagesync sync-group server-endpoint wait

將 CLI 置於等候狀態,直到符合伺服器端點的條件為止。

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

已註冊伺服器的資源識別碼或 GUID。

--server-local-path

已註冊伺服器的本機路徑。

--storage-sync-service

儲存體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--cloud-tiering

啟用或停用雲端階層處理的開關。 透過雲端階層處理,可將不常使用或存取的檔案分層處理至 Azure 檔案服務。

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

不等候長時間執行的作業完成。

--offline-data-transfer

要啟用或停用離線資料傳輸的切換。 透過離線資料傳輸,您可以使用替代方式,例如 Azure 資料箱,將大量檔案傳輸至 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 檔案共用在同步群組中一律會有完整的資料複本。

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

儲存體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--no-wait

不等候長時間執行的作業完成。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--yes -y

不提示確認。

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

儲存體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

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

儲存體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

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

儲存體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--cloud-tiering

啟用或停用雲端階層處理的開關。 透過雲端階層處理,可將不常使用或存取的檔案分層處理至 Azure 檔案服務。

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

不等候長時間執行的作業完成。

--offline-data-transfer

要啟用或停用離線資料傳輸的切換。 透過離線資料傳輸,您可以使用替代方式,例如 Azure 資料箱,將大量檔案傳輸至 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 檔案共用在同步群組中一律會有完整的資料複本。

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' 建立。

--custom

等候條件符合自訂 JMESPath 查詢。 例如 provisioningState!='InProgress',instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

--exists

等候資源存在。

--interval

以秒為單位輪詢間隔。

預設值: 30
--timeout

等候時間上限,以秒為單位。

預設值: 3600
--updated

等候在 'Succeeded' 上使用 provisioningState 進行更新。