az storagesync sync-group server-endpoint

注意

此參考是 Azure CLI 的 storagesync 擴充功能的一部分（2.55.0 版或更高版本）。 擴充功能會在您第一次執行 az storagesync sync-group server-endpoint 命令時自動安裝。 深入了解擴充功能。

管理伺服器端點。

命令

名稱	Description	類型	狀態
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

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

--server-local-path

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

--storage-sync-service

記憶體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--cloud-tiering

啟用或停用雲端階層處理的參數。 使用雲端階層處理時，不常使用或存取的檔案可以分層至 Azure 檔案儲存體。

接受的值: off, on

--no-wait

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

預設值: False

--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 檔案共用一律會有同步群組中數據的完整複本。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

記憶體同步服務的名稱或識別碼。

--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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

記憶體同步服務的名稱或識別碼。

--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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

記憶體同步服務的名稱或識別碼。

--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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

記憶體同步服務的名稱或識別碼。

--sync-group-name

同步群組的名稱。

選擇性參數

--cloud-tiering

啟用或停用雲端階層處理的參數。 使用雲端階層處理時，不常使用或存取的檔案可以分層至 Azure 檔案儲存體。

接受的值: off, on

--no-wait

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

預設值: False

--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 檔案共用一律會有同步群組中數據的完整複本。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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 Service 資源的名稱。

--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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。