Invoke-AzStorageSyncChangeDetection

Referência

Módulo:: Az.StorageSync

Esse comando pode ser usado para iniciar manualmente a deteçã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 podem ser detetados. Se o escopo das alterações for conhecido por você, limite a execução desse comando a partes do namespace, para que a deteçã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 itens executando o cmdlet sem esses parâmetros, invocando a deteção de alterações no nível do compartilhamento.

Nota

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

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

Se a deteção de alterações no nível de compartilhamento for invocada, todas essas alterações serão detetadas. Essas alterações também serão detetadas quando o trabalho de deteçã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, o Azure File Sync verifica o namespace dentro de um compartilhamento de arquivos do Azure sincronizando 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, finalmente, sincronizá-las com servidores conectados. Este comando pode ser usado para iniciar manualmente a deteçã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 deteção de alterações de itens individuais 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 deteção completa de alterações no nível do compartilhamento. O cmdlet Invoke-AzStorageSyncChangeDetection cancelará um trabalho de enumeração de alteração na nuvem em andamento. Para evitar o cancelamento de um trabalho em execução no momento, vá para 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 deteçã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 deteção de alterações é executada para um conjunto de arquivos que são conhecidos pelo chamador de comando como alterados. O objetivo é fazer com que a sincronização de arquivos do Azure também detete e sincronize essas alterações.

Exemplo 3

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

Neste exemplo, a deteção de alterações é executada para o diretório "Exemplos" e detetará recursivamente alterações em 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 deteção de alterações em todo o compartilhamento de arquivos.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DirectoryPath

Diretório onde a deteção de alterações será realizada.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

CloudEndpoint Object, normalmente passado através do parâmetro.

Tipo:	PSCloudEndpoint
Aliases:	CloudEndpoint
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Path

Caminho onde a deteção de alterações será executada.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Recursive

Indicação se a deteção de alteração de diretório é recursiva.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceId

ID do recurso do CloudEndpoint

Tipo:	String
Aliases:	CloudEndpointId
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-StorageSyncServiceName

Nome do StorageSyncService.

Tipo:	String
Aliases:	ParentName
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SyncGroupName

Nome do SyncGroup.

Tipo:	String
Position:	2
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

String

PSServerEndpoint

Saídas

Void

Partilhar via