Поделиться через


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

Входные данные

String

PSServerEndpoint

Выходные данные

Void