PowerShell Logo Small

Add-InitiatorIdToMaskingSet



This is the built-in help made by Microsoft for the command 'Add-InitiatorIdToMaskingSet', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Adds an initiator ID to an existing masking set, granting the host associated with the initiator ID access to the virtual disk and target port resources defined in the masking set.

SYNTAX


Add-InitiatorIdToMaskingSet [-MaskingSetFriendlyName] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-HostType <HostType>] [-InitiatorIds <String[]>] [-PassThru]
[-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Add-InitiatorIdToMaskingSet [-AsJob] [-CimSession <CimSession[]>] [-HostType <HostType>] [-InitiatorIds <String[]>] [-PassThru] [-ThrottleLimit <Int32>] -MaskingSetUniqueId
<String[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Add-InitiatorIdToMaskingSet [-AsJob] [-CimSession <CimSession[]>] [-HostType <HostType>] [-InitiatorIds <String[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject
<CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Add-InitiatorIdToMaskingSet cmdlet adds an initiator ID to an existing masking set, granting the host associated with the initiator ID access to the virtual disk and
target port resources defined in the masking set.


This cmdlet is not needed when using the Storage Spaces subsystem.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=294416
Get-InitiatorID
Get-InitiatorPort

REMARKS

<

Examples


Example 1: Adding an InitiatorID to a masking set by masking set object

PS C:\> $fcPorts = Get-InitiatorPort -CimSession Srv1 -ConnectionType FibreChannel
PS C:\> $maskingSet = Get-MaskingSet Cluster1MaskingSet
PS C:\> $fcPorts.NodeAddress 2000001b328d33cd2001001b32ad33cd
PS C:\> $maskingSet | Add-InitiatorIdToMaskingSet -InitiatorIds $fcPorts.NodeAddress



This example shows getting Fibre Channel initiator ports from the Srv1 computer, then getting the masking set object for the Cluster1MaskingSet, then enabling Srv1 access to
all virtual disks defined in the masking set.