PowerShell Logo Small

Add-InitiatorIdToMaskingSet



This is the built-in help made by Microsoft for the command 'Add-InitiatorIdToMaskingSet', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' 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>] -MaskingSetUn
iqueId <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 ac
cess to all virtual disks defined in the masking set.