Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Set-NaFpolicy


NAME
Set-NaFpolicy

SYNOPSIS
Manipulate a list of operations and network protocols for a policy.

SYNTAX
Set-NaFpolicy [-Name] <String> [-Operations] <String[]> [-Protocols] <String
[]> [[-OfflineOnly]] [[-Force]] [-Controller <NaController>] [-WhatIf] [-Con
firm] [<CommonParameters>]


DESCRIPTION
Manipulate a list of operations and network protocols for a policy. This det
ermines which user requests cause the filer to notify fpolicy servers for th
is policy. The list provided will replace the list currently in place, if an
y.

Note that this can be confusing to a server which has already connected to a
policy and provided a list of operations. For example, it may have requeste
d notifications when users open files, but start receiving notifications whe
n users create symlinks. This API is provided in support of "native file blo
cking" in which there is no server connected to the filer for a policy. Note
that it is possible to get the list of operations and protocols currently s
et for a policy with the fpolicy-list-info API.


PARAMETERS
-Name <String>
Name of the fpolicy to operate on.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Operations <String[]>
List of monitored operations. Supported values: "file-create", "file-de
lete", "file-open", "file-close", "file-rename", "directory-create", "di
rectory-delete", "directory-rename", "getattr", "setattr", "lookup", "re
ad", "write", "link", "symlink"

Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Protocols <String[]>
List of monitored operations' protocols. Supported values: "nfs", "cifs
"

Required? true
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false

-OfflineOnly
Sets the state of offline filtering. If offline filtering is set, then o
nly user requests for files which are marked "offline" cause notificatio
ns.

Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Force
If a server is connected to the filer and has already set the list of op
erations, should this API override the server's setting? If "force" is "
true", the policy's set of operations will be dropped and replaced with
the values provided by this API.

Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.Types.Fpolicy.PolicyInfo


NOTES


Category: fpolicy
API: fpolicy-operations-list-set

-------------- Example 1 --------------

C:\PS>Set-NaFpolicyOperations policy1 -Operations "file-create","file-delete
" -Protocols "cifs","nfs"


Sets the operations for policy1 to "file-create" and "file-delete" on both n
fs and cifs.


IsEnabled : False
MonitoredOperations : {file-create, file-delete}
MonitoredProtocols : {nfs, cifs}
Name : policy1
NumberOfScreenFailures : 0
NumberOfScreenedFiles : 0



RELATED LINKS
Get-NaFpolicy
New-NaFpolicy







 Data ONTAP® PowerShell Toolkit