Invoke-AzStorageSyncChangeDetection
Эта команда может использоваться для ручного запуска обнаружения изменений пространства имен. Он может быть нацелен на весь общий ресурс, вложенную папку или набор файлов. При выполнении команды с параметрами -DirectoryPath или -Path можно обнаружить не более 10 000 элементов. Если область изменений известна вам, ограничьте выполнение этой команды частями пространства имен, поэтому обнаружение изменений может завершиться быстро и в пределах ограничения на 10 000 элементов. Кроме того, можно избежать ограничения элемента, выполнив командлет без этих параметров, вызвав обнаружение изменений на уровне общего ресурса.
Заметка
Если выполнить с параметрами -DirectoryPath или -Path, команда не обнаружит следующие изменения в общей папке Azure:
- Удаленные файлы.
- Файлы, которые перемещаются из общей папки.
- Файлы, которые удаляются и создаются с тем же именем.
При вызове обнаружения изменений на уровне общего ресурса все эти изменения будут обнаружены. Эти изменения также будут обнаружены при выполнении запланированного задания обнаружения изменений.
Синтаксис
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Периодически синхронизация файлов Azure проверяет пространство имен внутри общей папки Azure для изменений, которые вошли в общую папку, другими средствами, кроме синхронизации. Цель состоит в том, чтобы определить эти изменения и в конечном итоге синхронизировать их с подключенными серверами. Эта команда может использоваться для ручного запуска обнаружения изменений пространств имен. Он может быть нацелен на весь общий ресурс, вложенную папку или набор файлов. Если область изменений известна, ограничьте выполнение этой команды частями пространства имен, поэтому обнаружение изменений отдельных элементов может быстро завершиться и в пределах ограничения на 10 000 элементов. В противном случае выполните команду без -DirectoryPath или -Path параметров для вызова полного обнаружения изменений на уровне общего ресурса. Командлет Invoke-AzStorageSyncChangeDetection отменит задание перечисления изменений в облаке, которое выполняется. Чтобы избежать отмены выполняемого задания, перейдите к свойствам облачной конечной точки на портале, чтобы проверить, выполняется ли задание в данный момент.
Примеры
Пример 1
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"
В этом примере обнаружение изменений выполняется в каталогах Data и Reporting\Templates для синхронизации общей папки Azure. Все пути относительны к корневому пространству имен общей папки Azure.
Пример 2
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"
В этом примере обнаружение изменений выполняется для набора файлов, известных вызывающей команде, которые изменились. Целью является обнаружение и синхронизация этих изменений в службе синхронизации файлов Azure.
Пример 3
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive
В этом примере обнаружение изменений выполняется для каталога Examples и рекурсивно обнаруживает изменения в подкаталогах. Помните, что командлет завершится ошибкой, если путь содержит более 10 000 элементов. Если путь содержит более 10 000 элементов, выполните команду в вложенных частях пространства имен.
Пример 4
Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"
В этом примере ни -DirectoryPath, ни -Path не переданы команде. Это вызовет обнаружение изменений во всем файловом ресурсе.
Параметры
-AsJob
Запуск командлета в фоновом режиме
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DirectoryPath
Каталог, в котором будет выполнено обнаружение изменений.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Объект CloudEndpoint, обычно передаваемый через параметр.
Тип: | PSCloudEndpoint |
Aliases: | CloudEndpoint |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
Имя CloudEndpoint. Имя — это GUID, а не понятное имя, отображаемое на портале. Чтобы получить CloudEndpointName, используйте командлет Get-AzStorageSyncCloudEndpoint.
Тип: | String |
Aliases: | CloudEndpointName |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
В обычном выполнении этот командлет не возвращает значения при успешном выполнении. Если указать параметр PassThru, командлет будет записывать значение в конвейер после успешного выполнения.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Path
Путь, в котором будет выполнено обнаружение изменений.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Recursive
Указывает, является ли обнаружение изменений каталога рекурсивным.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceGroupName
Имя группы ресурсов.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceId
Идентификатор ресурса CloudEndpoint
Тип: | String |
Aliases: | CloudEndpointId |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-StorageSyncServiceName
Имя службы StorageSyncService.
Тип: | String |
Aliases: | ParentName |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SyncGroupName
Имя SyncGroup.
Тип: | String |
Position: | 2 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Azure PowerShell