Invoke-AzStorageSyncChangeDetection

Referência

Módulo:: Az.StorageSync

Esse comando pode ser usado para iniciar manualmente a detecção de alterações de namespace. Ele pode ser direcionado para todo o compartilhamento, subpasta ou conjunto de arquivos. Ao executar o comando com os parâmetros -DirectoryPath ou -Path, um máximo de 10.000 itens pode ser detectado. Se o escopo das alterações for conhecido por você, limite a execução desse comando a partes do namespace, portanto, a detecção de alterações poderá ser concluída rapidamente e dentro do limite de 10.000 itens. Como alternativa, você pode evitar o limite de itens executando o cmdlet sem esses parâmetros, invocando a detecção de alterações no nível do compartilhamento.

Nota

Se for executado com parâmetros -DirectoryPath ou -Path, o comando não detectará as seguintes alterações no compartilhamento de arquivos do Azure:

Arquivos excluídos.
Arquivos que são movidos para fora do compartilhamento.
Arquivos excluídos e criados com o mesmo nome.

Se a detecção de alterações no nível do compartilhamento for invocada, todas essas alterações serão detectadas. Essas alterações também serão detectadas quando o trabalho de detecção de alterações agendado for executado.

Sintaxe

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

Description

Periodicamente, a Sincronização de Arquivos do Azure verifica o namespace dentro de um compartilhamento de arquivos do Azure sincronizando se há alterações que entraram no compartilhamento de arquivos por outros meios além da sincronização. O objetivo é identificar essas alterações e, por fim, sincronizá-las com servidores conectados. Esse comando pode ser usado para iniciar manualmente a detecção de alterações de namespaces. Ele pode ser direcionado para todo o compartilhamento, subpasta ou conjunto de arquivos. Se o escopo das alterações for conhecido por você, limite a execução desse comando a partes do namespace, para que a detecção de alteração de item individual possa ser concluída rapidamente e dentro do limite de 10.000 itens. Caso contrário, execute o comando sem os parâmetros -DirectoryPath ou -Path para invocar a detecção completa de alterações no nível do compartilhamento. O cmdlet Invoke-AzStorageSyncChangeDetection cancelará um trabalho de enumeração de alterações na nuvem que está em andamento. Para evitar o cancelamento de um trabalho em execução no momento, acesse as propriedades do Ponto de Extremidade de Nuvem no portal para verificar se um trabalho está em execução no momento.

Exemplos

Exemplo 1

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"

Neste exemplo, a detecção de alterações é executada nos diretórios "Dados" e "Relatórios\Modelos" de um compartilhamento de arquivos do Azure sincronizando. Todos os caminhos são relativos à raiz do namespace de compartilhamento de arquivos do Azure.

Exemplo 2

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"

Neste exemplo, a detecção de alterações é executada para um conjunto de arquivos que são conhecidos pelo chamador de comando que foram alterados. A meta é fazer com que a sincronização de arquivos do Azure detecte e sincronize essas alterações também.

Exemplo 3

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive

Neste exemplo, a detecção de alterações é executada para o diretório "Exemplos" e detectará recursivamente alterações em subdiretórios. Tenha em mente que o cmdlet falhará se o caminho contiver mais de 10.000 itens. Se o caminho contiver mais de 10.000 itens, execute o comando em sub-partes do namespace.

Exemplo 4

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"

Neste exemplo, nem -DirectoryPath nem -Path foi passado para o comando. Isso invocará a detecção de alterações em todo o compartilhamento de arquivos.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DirectoryPath

Diretório em que a detecção de alterações será executada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Objeto CloudEndpoint, normalmente passado pelo parâmetro.

Tipo:	PSCloudEndpoint
Aliases:	CloudEndpoint
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Nome do CloudEndpoint. O nome é um GUID, não o nome amigável exibido no portal. Para obter o CloudEndpointName, use o cmdlet Get-AzStorageSyncCloudEndpoint.

Tipo:	String
Aliases:	CloudEndpointName
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Na execução normal, esse cmdlet não retorna nenhum valor em caso de êxito. Se você fornecer o parâmetro PassThru, o cmdlet gravará um valor no pipeline após a execução bem-sucedida.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

Caminho em que a detecção de alterações será executada.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Recursive

Indicação se a detecção de alterações de diretório é recursiva.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceId

ID de recurso do CloudEndpoint

Tipo:	String
Aliases:	CloudEndpointId
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-StorageSyncServiceName

Nome do StorageSyncService.

Tipo:	String
Aliases:	ParentName
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SyncGroupName

Nome do SyncGroup.

Tipo:	String
Cargo:	2
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

PSServerEndpoint

Saídas

Void

Compartilhar via