Invoke-AzStorageSyncChangeDetection
Эта команда может использоваться для ручного запуска обнаружения изменений пространства имен. Он может быть нацелен на весь общий ресурс, вложенную папку или набор файлов. При выполнении команды с параметрами -DirectoryPath или -Path можно обнаружить не более 10 000 элементов. Если область изменений известна вам, ограничьте выполнение этой команды частями пространства имен, поэтому обнаружение изменений может завершиться быстро и в пределах ограничения на 10 000 элементов. Кроме того, можно избежать ограничения элемента, выполнив командлет без этих параметров, вызвав обнаружение изменений на уровне общего ресурса.
Замечание
При запуске с параметрами -DirectoryPath или -Path команда не обнаружит следующие изменения в Azure общей папке:
Удаленные файлы.
Файлы, которые перемещаются из общей папки.
Файлы, которые удаляются и создаются с тем же именем.
При вызове обнаружения изменений на уровне общего ресурса все эти изменения будут обнаружены. Эти изменения также будут обнаружены при выполнении задания обнаружения запланированных изменений.
Синтаксис
FullShareStringParameterSet (По умолчанию)
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
StringAndDirectoryParameterSet
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
StringAndPathParameterSet
Invoke-AzStorageSyncChangeDetection
[-ResourceGroupName] <String>
[-StorageSyncServiceName] <String>
[-SyncGroupName] <String>
-Name <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdAndDirectoryParameterSet
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdAndPathParameterSet
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FullShareResourceIdParameterSet
Invoke-AzStorageSyncChangeDetection
[-ResourceId] <String>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectAndDirectoryParameterSet
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-DirectoryPath <String>
[-Recursive]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectAndPathParameterSet
Invoke-AzStorageSyncChangeDetection
[-InputObject] <PSCloudEndpoint>
-Path <String[]>
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FullShareObjectParameterSet
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
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Cf
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DirectoryPath
Каталог, в котором будет выполнено обнаружение изменений.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
StringAndDirectoryParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ResourceIdAndDirectoryParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ObjectAndDirectoryParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
Объект CloudEndpoint, обычно передаваемый через параметр.
Тип: PSCloudEndpoint
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: CloudEndpoint
ObjectAndDirectoryParameterSet
Position: 0
Обязательно: True
Значение из конвейера: True
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ObjectAndPathParameterSet
Position: 0
Обязательно: True
Значение из конвейера: True
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
FullShareObjectParameterSet
Position: 0
Обязательно: True
Значение из конвейера: True
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Name
Имя CloudEndpoint. Имя — это GUID, а не понятное имя, отображаемое на портале. Чтобы получить CloudEndpointName, используйте командлет Get-AzStorageSyncCloudEndpoint.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: CloudEndpointName
Наборы параметров
FullShareStringParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndDirectoryParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndPathParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PassThru
В обычном выполнении этот командлет не возвращает значения при успешном выполнении. Если указать параметр PassThru, командлет будет записывать значение в конвейер после успешного выполнения.
Свойства параметров
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Path
Путь, в котором будет выполнено обнаружение изменений.
Свойства параметров
Тип: String [ ]
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
StringAndPathParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ResourceIdAndPathParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ObjectAndPathParameterSet
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Recursive
Указывает, является ли обнаружение изменений каталога рекурсивным.
Свойства параметров
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
StringAndDirectoryParameterSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ResourceIdAndDirectoryParameterSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
ObjectAndDirectoryParameterSet
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ResourceGroupName
Имя группы ресурсов.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
FullShareStringParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndDirectoryParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndPathParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ResourceId
Идентификатор ресурса CloudEndpoint
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: CloudEndpointId
Наборы параметров
ResourceIdAndDirectoryParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
ResourceIdAndPathParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
FullShareResourceIdParameterSet
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-StorageSyncServiceName
Имя службы StorageSyncService.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Имя родителя
Наборы параметров
FullShareStringParameterSet
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndDirectoryParameterSet
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndPathParameterSet
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SyncGroupName
Имя SyncGroup.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
FullShareStringParameterSet
Position: 2
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndDirectoryParameterSet
Position: 2
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
StringAndPathParameterSet
Position: 2
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметров
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Wi
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные