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 a 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 podem ser detectados. 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ções possa ser concluída rapidamente e dentro do limite de 10.000 itens. Como alternativa, você pode evitar o limite de item executando o cmdlet sem esses parâmetros, invocando a detecção de alterações no nível do compartilhamento.

Observação

Se executado com os 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ção 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 sincronizado em busca de alterações que entraram no compartilhamento de arquivos por outros meios que não a sincronização. O objetivo é identificar essas alterações e, por fim, sincronizá-las com os servidores conectados. Esse comando pode ser usado para iniciar manualmente a detecção de alterações de namespaces. Ele pode ser direcionado a 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ção de nuvem que está em andamento. Para evitar o cancelamento de um trabalho em execução no momento, acesse as propriedades do Cloud Endpoint 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 sincronizado. 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 comandos como tendo sido alterados. O objetivo é 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 as alterações nos subdiretórios. Lembre-se de 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 subpartes do namespace.

Exemplo 4

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

Neste exemplo, nem -DirectoryPath nem -Path foram passados 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 sua 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 a 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 onde 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

CloudEndpoint Object, 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 onde 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ção 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 do 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