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, 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 itens executando o cmdlet sem esses parâmetros, invocando a detecção de alterações no nível de 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 que são excluídos.
Arquivos que são movidos para fora do compartilhamento.
Arquivos que são excluídos e criados com o mesmo nome.

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

Syntax

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 de sincronização em busca de alterações que vieram 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. 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çõ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 detecção completa de alterações no nível de compartilhamento. O cmdlet Invoke-AzStorageSyncChangeDetection cancelará um trabalho de enumeração de alteração na nuvem que está 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 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 comando como alterados. O objetivo é que a sincronização de arquivos do Azure também detecte 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 detecção de alterações é executada para o diretório "Exemplos" e detectará 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 detecção de alterações em todo o compartilhamento de arquivos.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectoryPath

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

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

CloudEndpoint Object, normalmente passado pelo parâmetro.

Tipo:	PSCloudEndpoint
Aliases:	CloudEndpoint
Position:	0
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Tipo:	String
Aliases:	CloudEndpointName
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	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
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

Tipo:	String[]
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Recursive

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

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:	String
Position:	0
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

ID do recurso CloudEndpoint

Tipo:	String
Aliases:	CloudEndpointId
Position:	0
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageSyncServiceName

Nome do StorageSyncService.

Tipo:	String
Aliases:	ParentName
Position:	1
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncGroupName

Nome do SyncGroup.

Tipo:	String
Position:	2
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

PSServerEndpoint

Saídas

Void

Compartilhar via